...
This procedure will build a single guide based on the files on your local machine. It can help sanity check, but you must also test all guides using the "Test all guides" process below.
- Optional: In Finder, go to the directory for the guide you want to build. If there is an existing
build
subdirectory, delete it. - At a command prompt, cd to the directory of the guide you want to build. For example,
course_authors.
- Enter the following command:
make html
The command builds the project from scratch. (If you did not remove thebuild
subdirectory in step 1, recently introduced problems might not be detected.) - Review results for the project. If there are warnings or errors, address and run again.
NOTE: If the file you've changed is shared by multiple guides (files in the shared directory), you need to build and test all of the impacted guides. To locally build all guides that have directories under en_us, cd
to the en_us directory and run make html
.
...
- At a command prompt, go to the
edx-documentation
directory. - Enter the following command:
./run_tests.sh
The command will build all projects from scratch. - Review results at the end. If there are warnings or errors, address and run again.
Test Links (doc team only)
About once every six months, run the linkchecker tool in Sphinx to make sure all the links work.
- At a command prompt,
cd
to theen_us
directory. - Enter the following command:
make linkchecker
The command checks all links in all projects. - Review results for the project. If there are warnings or errors, address and run again.
For more information, see the final comment on documentation PR 1267.