2 Revamping and restructuring Automotive Grade Linux's documentation site under GSoD'20.
4 -> [The working documentation site.](https://docs-agl.readthedocs.io)
6 -> [ReadTheDocs project page.](https://readthedocs.org/projects/docs-agl/)
8 The [documentation gerrit repository](https://gerrit.automotivelinux.org/gerrit/admin/repos/AGL/documentation) contains AGL documentation website template and content, rendering is visible at [https://docs-agl.readthedocs.io/en/latest/](https://docs-agl.readthedocs.io/en/latest/). The documentation site is hosted on [readthedocs](https://readthedocs.org/projects/docs-agl/) and corresponding builds are mentioned [here](https://readthedocs.org/projects/docs-agl/builds/).
10 ## Download Repository
12 Kindly check [this](https://wiki.automotivelinux.org/agl-distro/contributing) and clone with commit-msg hook :
15 $ git clone "ssh://$USER@gerrit.automotivelinux.org:29418/AGL/documentation" && scp -p -P 29418 $USER@gerrit.automotivelinux.org:hooks/commit-msg "documentation/.git/hooks/"
18 ## Building a local site
20 1. Change into the directory
26 2. Install MkDocs and rtd-dropdown theme
29 $ sudo pip install -r requirements.txt
32 3. Serve locally (defaultly rendered at [127.0.0.1:8000/](127.0.0.1:8000/)):
38 Process to **add new or edit existing** markdown files to AGL documentation:
40 ## Directory Structure
42 Find existing or add new markdowns in the following directory structure.
47 │ ├── 0_Getting_Started
49 │ │ └── 2_Building_AGL_Image
52 | ├──<Chapter-Number>_<Chapter-Name>
53 | | ├──<Subchapter-Number>_<Subchapter-Name>
54 | | | ├──<Index-Number>_<Markdown-Title>.md
58 ## Markdown Formatting
60 1. Add following at the start of each markdown :
71 [<enter-title>](../<Chapter-Number>_<Chapter-Name>/<Subchapter-Number>_<Subchapter-Name>/<Index-Number>_<Markdown-Title>.md)
76 [LinkChecker](https://wummel.github.io/linkchecker/) is a tool that allows to check all the hyperlinks in the site.
78 For testing hyperlinks as soon as the local site is running, do:
81 linkchecker http://localhost:8000
84 The ```linkchecker``` output will display the broken link and there location
93 #recent version of git-review (>=1.28.0 is required)
94 sudo pip3 install git-review
97 2. Write commit message
100 # track all the new changes
103 # Write the commit message
107 3. Push changes for review to Gerrit