diff --git a/docs/guides/celery.rst b/docs/guides/how-tos/celery.rst similarity index 100% rename from docs/guides/celery.rst rename to docs/guides/how-tos/celery.rst diff --git a/docs/guides/how-tos/index.rst b/docs/guides/how-tos/index.rst new file mode 100644 index 0000000000..cb85be6be4 --- /dev/null +++ b/docs/guides/how-tos/index.rst @@ -0,0 +1,8 @@ +"How-To" Guides +############### + + +.. toctree:: + :glob: + + * diff --git a/docs/guides/index.rst b/docs/guides/index.rst index 49ce6eb8cb..d8e83e8b82 100644 --- a/docs/guides/index.rst +++ b/docs/guides/index.rst @@ -24,12 +24,42 @@ locations. .. toctree:: :maxdepth: 1 - lms_apis - guides docstrings/docstrings - celery - settings - featuretoggles + +.. toctree:: + :hidden: + + how-tos/index + references/index + concepts/index + +.. grid:: 1 2 2 2 + :gutter: 3 + :padding: 0 + + .. grid-item-card:: How-tos + :class-card: sd-shadow-md sd-p-2 + :class-footer: sd-border-0 + + * :doc:`how-tos/celery` + +++ + .. button-ref:: how-tos/index + :color: primary + :outline: + :expand: + + .. grid-item-card:: Referencs + :class-card: sd-shadow-md sd-p-2 + :class-footer: sd-border-0 + + * :doc:`references/lms_apis` + * :doc:`references/settings` + * :doc:`references/featuretoggles` + +++ + .. button-ref:: references/index + :color: primary + :outline: + :expand: Change History diff --git a/docs/guides/featuretoggles.rst b/docs/guides/references/featuretoggles.rst similarity index 100% rename from docs/guides/featuretoggles.rst rename to docs/guides/references/featuretoggles.rst diff --git a/docs/guides/references/index.rst b/docs/guides/references/index.rst new file mode 100644 index 0000000000..7d7821ed23 --- /dev/null +++ b/docs/guides/references/index.rst @@ -0,0 +1,8 @@ +References +########## + +.. toctree:: + :maxdepth: 1 + :glob: + + * diff --git a/docs/guides/lms_apis.rst b/docs/guides/references/lms_apis.rst similarity index 66% rename from docs/guides/lms_apis.rst rename to docs/guides/references/lms_apis.rst index 7c77b47e50..b2a95489ed 100644 --- a/docs/guides/lms_apis.rst +++ b/docs/guides/references/lms_apis.rst @@ -4,4 +4,4 @@ LMS APIs The LMS currently has the following API Endpoints. -.. openapi:: ../lms-openapi.yaml +.. openapi:: ../../lms-openapi.yaml diff --git a/docs/guides/settings.rst b/docs/guides/references/settings.rst similarity index 100% rename from docs/guides/settings.rst rename to docs/guides/references/settings.rst