subiquity/doc
Robert Krátký 215e50fa5a Fix docs path for theme to function. 2023-10-18 13:59:32 +02:00
..
.sphinx Adopt Docs Starter Pack config. 2023-10-06 14:50:56 +02:00
development Add README.md and rename folder 2023-06-07 10:14:31 +01:00
explanation Applying suggestions 2023-09-04 11:34:19 +01:00
howto FR-5578: Add support for variable substitutions. 2023-10-06 08:55:44 -06:00
reference FR-5630 Fix Sphinx YAML syntax warning. 2023-10-12 14:12:32 +02:00
reuse FR-5578: Add support for variable substitutions. 2023-10-06 08:55:44 -06:00
tutorial Add content and change to reST 2023-08-14 11:36:26 +01:00
.gitignore doc: gitignores 2023-07-06 18:07:37 -06:00
.wokeignore Adopt Docs Starter Pack config. 2023-10-06 14:50:56 +02:00
.wordlist.txt Adopt Docs Starter Pack config. 2023-10-06 14:50:56 +02:00
Makefile Adopt Docs Starter Pack config. 2023-10-06 14:50:56 +02:00
README.md Add content and change to reST 2023-08-14 11:36:26 +01:00
conf.py Adopt Docs Starter Pack config. 2023-10-06 14:50:56 +02:00
custom_conf.py Fix docs path for theme to function. 2023-10-18 13:59:32 +02:00
index.rst Add content and change to reST 2023-08-14 11:36:26 +01:00
intro-to-autoinstall.rst FR-5630 Fix rST heading syntax. 2023-10-12 14:11:52 +02:00

README.md

Documentation

This doc folder is the future location of documentation for Subiquity. This will be used to migrate the official documentation to readthedocs, and later will be the home of that documentation.

The ../documentation folder is the existing location for this sort of documentation. As the RTD version is not yet ready, documentation changes should be made to ../documentation until this README is updated to say otherwise. As such, please make any desired documentation changes to ../documentation.

Local preview

To build this documentation, you can run make install from this folder to create the virtual environment.

Then run the make run command, which will build a html version of the docs, and serve the docs in the virtual environment. This is very convenient if you are working on them and want your saved changes to be reflected as a working preview.