WIP for 2027 - Time to Get Discussions going

source/_templates/sidebar/brand.html

@@ -3,7 +3,7 @@
 {% block brand_content %} 
 {% if not theme_sidebar_hide_name %}
 <span class="sidebar-brand-text"
-  >{{ project }}</span
+  ><strong>{{ project }}</strong></span
 >{% endif %}
 {%- if logo_url %}
 <div class="sidebar-logo-container">

source/conf.py

@@ -23,7 +23,7 @@
 
 # -- Project information -----------------------------------------------------
 
-project = "WPILib Documentation"
+project = "FIRST Robotics"
 copyright = "2026, FIRST and other WPILib Contributors. This work is licensed under a Creative Commons Attribution 4.0 International License"
 author = "WPILib"
 version = "2027"
@@ -118,7 +118,7 @@
 
 # Configure OpenGraph support
 ogp_site_url = "https://docs.wpilib.org/en/stable/"
-ogp_site_name = "WPILib Documentation"
+ogp_site_name = "FIRST Robotics Documentation"
 ogp_image = "https://raw.githubusercontent.com/wpilibsuite/branding/main/export/png/wpilib-icon-256.png"
 
 # Configure photofinish ci mode
@@ -142,7 +142,7 @@
 todo_emit_warnings = False
 
 # TODO Directives are shown in output
-todo_include_todos = True
+todo_include_todos = False
 
 # Disable following anchors in URLS for linkcheck
 linkcheck_anchors = True
@@ -254,14 +254,15 @@
 html_baseurl = "https://docs.wpilib.org/en/stable/"
 
 html_theme_options = {
+    "announcement": "&#x26A0;&#xFE0F; <strong>DRAFT</strong> &mdash; This site is a work in progress and does not reflect final 2027 documentation. Content may be incomplete or inaccurate.",
     "light_css_variables": {
         "color-sidebar-background": "#003974",
         "color-sidebar-brand-text": "#ffffffcc",
         "color-sidebar-link-text--top-level": "#d9d9d9",
         "color-background-hover": "#023160",
         "color-sidebar-link-text": "#acb1b9",
         "color-sidebar-caption-text": "#81868d",
-    }
+    },
 }
 
 html_sidebars = {
@@ -283,6 +284,7 @@
 
 def setup(app):
     app.add_css_file("css/wpilib-rtd.css")
+    app.add_css_file("css/sw-components.css")
 
     # Local Api Docs support
     app.add_js_file("js/api-docs-redirect.js")
@@ -338,7 +340,17 @@ def setup(app):
     "printindex": r"\footnotesize\raggedright\printindex",
 }
 
-suppress_warnings = ["epub.unknown_project_files"]
+latex_documents = [
+    (
+        master_doc,
+        "wpilib.tex",
+        "FIRST Robotics Documentation",
+        author,
+        "manual",
+    )
+]
+
+suppress_warnings = ["epub.unknown_project_files", "ref.ref"]
 
 
 # Options for translation support -------------------------------------------

source/docs/ftc/index.rst

@@ -0,0 +1,68 @@
+# FTC with WPILib
+
+.. raw:: html
+
+
+   <div class="sw-coming">
+     <div class="sw-coming-icon">&#x1F6A7;</div>
+     <div class="sw-coming-h">FTC Documentation Coming Soon</div>
+     <p class="sw-coming-p">
+       Full WPILib support for FIRST Tech Challenge arrives with the
+       <strong>Systemcore</strong> and <strong>Motioncore</strong> controllers.
+       Documentation will be published here ahead of the 2027-2028 FTC season.
+     </p>
+     <a href="https://wpilib.org/blog" style="font-size:0.875rem;font-weight:600;
+        color:var(--ftc);">Follow the WPILib blog for updates &rarr;</a>
+   </div>
+
+   <p class="sw-section-h">What to Expect</p>
+
+   <div class="sw-grid sw-grid-2">
+     <div class="sw-card sw-card-ftc">
+       <div class="sw-label sw-label-ftc">FTC 2027-2028+</div>
+       <div class="sw-card-title">Systemcore + Motioncore</div>
+       <div class="sw-card-desc">
+         New controllers bringing full WPILib support to FTC.
+         Same Java, Python, and Blockly toolchain as FRC.
+       </div>
+     </div>
+     <div class="sw-card sw-card-ftc">
+       <div class="sw-label sw-label-ftc">FTC 2027-2028+</div>
+       <div class="sw-card-title">OnBot Programming</div>
+       <div class="sw-card-desc">
+         Java, Python, Blockly, and LabVIEW available directly in the
+         browser &mdash; no local installation required.
+       </div>
+     </div>
+   </div>
+
+   <p class="sw-section-h">Get a Head Start Today</p>
+
+   <div class="sw-grid sw-grid-2">
+     <a class="sw-card sw-card-shared" href="../xrp-robot/index.html">
+       <div class="sw-label sw-label-shared">Available Now</div>
+       <div class="sw-card-title">Practice with the XRP</div>
+       <div class="sw-card-desc">
+         Learn WPILib programming on the $75 XRP desktop robot.
+         The same skills transfer directly to Systemcore.
+       </div>
+     </a>
+     <a class="sw-card sw-card-shared" href="../software/what-is-wpilib.html">
+       <div class="sw-label sw-label-shared">Available Now</div>
+       <div class="sw-card-title">What is WPILib?</div>
+       <div class="sw-card-desc">
+         Overview of WPILib tools, languages, and how FTC fits into
+         the broader WPILib ecosystem.
+       </div>
+     </a>
+   </div>
+
+   <div style="margin-top:8px;padding:14px 18px;background:var(--ftc-light);
+      border:1px solid rgba(224,112,0,0.3);border-radius:6px;
+      font-size:0.875rem;line-height:1.6;">
+     <strong>Currently using REV Duo?</strong>
+     Continue programming with the FTC SDK as normal.
+     Full documentation at
+     <a href="https://ftc-docs.firstinspires.org" style="color:var(--ftc);font-weight:600;">
+     ftc-docs.firstinspires.org</a>.
+   </div>