From 948e6e1f3a66bc86031dd06037d341ec9a0de8d8 Mon Sep 17 00:00:00 2001 From: Katrina Prosise Date: Fri, 9 Jan 2026 10:27:55 -0500 Subject: [PATCH] Cleanup toc on homepage MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hide the ToC, replaced with cards containing short descriptions of each "book". QA: ran build and viewed output. No issues to report. This commit addresses issue FFTK-4531, "trim TOC…" Signed-off-by: Katrina Prosise --- source/conf.py | 4 ++-- source/getting-started/index.rst | 2 ++ source/index.rst | 41 ++++++++++++++++++++++++++------ 3 files changed, 38 insertions(+), 9 deletions(-) diff --git a/source/conf.py b/source/conf.py index 0581138a..64463070 100644 --- a/source/conf.py +++ b/source/conf.py @@ -269,8 +269,8 @@ 'image_dark': '_static/logo-dark.png', }, 'logo_link': 'https://cta-eu1.hubspot.com/web-interactives/public/v1/track/redirect?encryptedPayload=AVxigLJoSaECsY7AgSp8%2B%2FzAJj9MjRdktrFWem7ZiLYUuwu9Ps5ktV52C%2Fp4Nxue86Go1wQ8PAPPjmbHy5hgIFaiHKCuH8%2BKOg1V2VD010z%2BH2jGMmM%3D&webInteractiveContentId=113594058467&portalId=26493592', - 'collapse_navigation': True, - 'show_nav_level': 2, + 'collapse_navigation': False, + 'show_nav_level': 0, 'navbar_start': ['navbar-logo','docsearch',], 'navbar_center': ['navbar-nav',], 'navbar_persistent': [], diff --git a/source/getting-started/index.rst b/source/getting-started/index.rst index ac6bc2cc..11b599c9 100644 --- a/source/getting-started/index.rst +++ b/source/getting-started/index.rst @@ -1,3 +1,5 @@ +.. _getting-started: + Getting Started =============== diff --git a/source/index.rst b/source/index.rst index 278e098f..3c753d78 100644 --- a/source/index.rst +++ b/source/index.rst @@ -15,20 +15,41 @@ The FoundriesFactory Platform brings together key features and functions for dev Documentation Overview ---------------------- +.. grid:: -* Getting Started will guide you from :ref:`gs-signup` and creating your :term:`Factory`, to :ref:`gs-flash-device`, - installing the CLI tool :term:`Fioctl` for interacting with your Factory, and the basics of building and deploying an App. + .. grid-item-card:: Getting Started + :link: getting-started + :link-type: ref + :link-alt: getting started + + Create your Factory, learn how to interact with it, and deploy an App -* :ref:`Tutorials ` will familiarize you with the workflow you will need to get the most from your Factory. + .. grid-item-card:: Tutorials + :link: tutorials + :link-type: ref + :link-alt: tutorials -* :ref:`User Guide ` walks you through common tasks and settings for your Factory. + Familiarize yourself with the workflow to get the most from your Factory -* Advanced use cases and technical details are in the :ref:`Reference Manual `. + .. grid-item-card:: User Guide + :link: user-guide + :link-type: ref + :link-alt: user guide + + Common tasks and settings for your Factory + + .. grid-item-card:: Reference Manual + :link: ref-manual + :link-type: ref + :link-alt: reference manual + + Advanced use cases and technical details .. toctree:: :maxdepth: 2 :caption: Getting Started :name: sec-learn + :hidden: getting-started/index @@ -36,6 +57,7 @@ Documentation Overview :maxdepth: 2 :caption: Tutorials :name: sec-tutorials + :hidden: tutorials/index @@ -44,6 +66,7 @@ Documentation Overview :glob: :caption: User Guide :name: sec-user-guide + :hidden: user-guide/index @@ -51,20 +74,24 @@ Documentation Overview :maxdepth: 2 :caption: Reference Manual :name: sec-manual + :hidden: reference-manual/index .. toctree:: + :maxdepth: 1 :caption: Appendix :name: sec-appendix + :hidden: - appendix/index + Fioctl Reference .. toctree:: :caption: Glossary :name: sec-glossary + :hidden: - glossary/index + Terms .. toctree:: :caption: Release Notes