WIP for 2027 - Time to Get Discussions going - #3320
Conversation
be203f1 to
88df58f
Compare
for all. I don't like pages that FRC comes before FTC, might be worth moving FTC to appear first. I had help from Claude, so wording may be wrong still. Draft open for discussion: we can keep all, parts, or none of it.
|
It looks great, but I'm worried about the maintainability of a bunch of raw HTML. I'm guessing it also doesn't translate. Have you seen how far you can get with the customization of sphinx-design? |
I just saw this message, need to work on my github notifications. I'll look into this. |
…T also fix step 1 layout
| <a class="wl-core-card" href="docs/software/dashboards/index.html"><div class="wl-core-title">Dashboards</div><div class="wl-core-desc">Elastic, AdvantageScope, Glass, and NetworkTables for real-time telemetry.</div></a> | ||
| <a class="wl-core-card" href="docs/software/advanced-controls/index.html"><div class="wl-core-title">Advanced Controls</div><div class="wl-core-desc">PID, feedforward, state-space, kinematics, and system identification.</div></a> | ||
| <a class="wl-core-card" href="docs/software/wpilib-tools/robot-simulation/index.html"><div class="wl-core-title">Simulation</div><div class="wl-core-desc">Test robot code on your laptop : no hardware required.</div></a> | ||
| <a class="wl-core-card" href="https://github.wpilib.org/allwpilib/docs/release/java/index.html"><div class="wl-core-title">API Reference</div><div class="wl-core-desc">Java, C++, and Python class and method documentation.</div></a> |
There was a problem hiding this comment.
This only links to the java API docs. There probably needs to be a landing page with the three links.
There was a problem hiding this comment.
made a new landing page
| # -- Project information ----------------------------------------------------- | ||
|
|
||
| project = "WPILib Documentation" | ||
| project = "FIRST Robotics" |
| # Configure OpenGraph support | ||
| ogp_site_url = "https://docs.wpilib.org/en/stable/" | ||
| ogp_site_name = "WPILib Documentation" | ||
| ogp_site_name = "FIRST Robotics Documentation" |
| <div class="wl-ret-label wl-frc-label">FRC</div> | ||
| <h3 class="wl-ret-h">Pre-Season Checklist</h3> | ||
| <ul> | ||
| <li>Download and run the <strong>2027 WPILib installer</strong></li> |
There was a problem hiding this comment.
These should all have links to the appropriate articles
| <h3 class="wl-ret-h">Pre-Season Checklist</h3> | ||
| <ul> | ||
| <li>Download and run the <strong>2027 WPILib installer</strong></li> | ||
| <li>Flash your Systemcore using <strong>FRC 2027 Game Tools</strong></li> |
This feels a little odd, but I'm not sure a good fix. For example, is this the place to spell them out, or can that be elsewhere so that the FRC/FTC "tags" look like they do in the rest of the page. And does it need to be in a separate line, or can it replace the colored text? |
removed the icons, and spelled out in the colored text. I didn't put the acronyms in this commit but will be changed in the next one |
… darkmode and adjust a couple more pages
2 participants
Major changes to homepage and getting started, trying to keep one page for all. I don't like pages that FRC comes before FTC, might be worth moving FTC to appear first. I had help from Claude, so wording may be wrong still.
Draft open for discussion: we can keep all, parts, or none of it.