diff --git a/README.md b/README.md index 4c37c1a..5caa72d 100644 --- a/README.md +++ b/README.md @@ -2,18 +2,21 @@ ![Vector](docs/source/images/vector-sdk-alpha.jpg) -Learn more about Vector: https://www.anki.com/vector +Learn more about Vector: https://www.anki.com/en-us/vector Learn more about the SDK: https://developer.anki.com/ -SDK documentation: http://developer.anki.com/vector/docs/ +SDK documentation: https://developer.anki.com/vector/docs/index.html Forums: https://forums.anki.com/ ## Getting Started -You can follow steps [here](http://developer.anki.com/vector/docs/) to set up your Vector robot with the SDK. +You can follow steps [here](https://developer.anki.com/vector/docs/index.html) to set up your Vector robot with the SDK. + +You can also generate a local copy of the SDK documetation by +following the instructions in the `docs` folder of this project. ## Privacy Policy and Terms and Conditions diff --git a/docs/README.md b/docs/README.md index 457b3b0..2bfb8cf 100644 --- a/docs/README.md +++ b/docs/README.md @@ -7,6 +7,14 @@ so changes to the source code will be reflected in docs builds. To update and build the docs, follow the steps below. +## Installing sphinx + +The +[Sphinx Documetation Generator](https://www.sphinx-doc.org/en/master/) +is used to build the docs. You'll need to have it installed on your +system with `pip install -r requirements.txt` using the +`requirements.txt` file in this directory and not the main project directory. + ## Updating the Docs There are a few files that are not automatically generated and reside in `source`. For example, @@ -22,3 +30,6 @@ the html version of the docs. make clean make html ``` + +You will now have an offline copy of the documetation that can be +accessed by opening `.build/html/index.html` diff --git a/docs/requirements.txt b/docs/requirements.txt new file mode 100644 index 0000000..51674ac --- /dev/null +++ b/docs/requirements.txt @@ -0,0 +1,3 @@ +sphinx +sphinx-autodoc-typehints +sphinx_rtd_theme