nodir | 469b2a1 | 2015-09-14 16:20:21 | [diff] [blame] | 1 | # Chromium docs |
| 2 | |
pwnall | 3f91838 | 2016-11-16 17:22:12 | [diff] [blame^] | 3 | This directory contains chromium project documentation in |
| 4 | [Gitiles-flavored Markdown]. |
nodir | 469b2a1 | 2015-09-14 16:20:21 | [diff] [blame] | 5 | It is automatically |
| 6 | [rendered by Gitiles](https://chromium.googlesource.com/chromium/src/+/master/docs/). |
| 7 | |
| 8 | ## Style guide |
| 9 | |
| 10 | Markdown documents must follow the [style guide]. |
| 11 | |
nodir | 6efa499 | 2015-12-20 00:54:33 | [diff] [blame] | 12 | ## Previewing changes |
| 13 | |
| 14 | You can preview your local changes using [md_browser]: |
| 15 | |
| 16 | ```bash |
| 17 | # in chromium checkout |
agable | d40b954 | 2016-05-11 01:15:06 | [diff] [blame] | 18 | ./tools/md_browser/md_browser.py |
nodir | 6efa499 | 2015-12-20 00:54:33 | [diff] [blame] | 19 | ``` |
| 20 | |
| 21 | To review someone else's changes, apply them locally first: |
| 22 | |
| 23 | ```bash |
| 24 | # in chromium checkout |
| 25 | git cl patch <CL number or URL> |
agable | d40b954 | 2016-05-11 01:15:06 | [diff] [blame] | 26 | ./tools/md_browser/md_browser.py |
nodir | 6efa499 | 2015-12-20 00:54:33 | [diff] [blame] | 27 | ``` |
| 28 | |
pwnall | 3f91838 | 2016-11-16 17:22:12 | [diff] [blame^] | 29 | [Gitiles-flavored Markdown]: https://gerrit.googlesource.com/gitiles/+/master/Documentation/markdown.md |
nodir | 469b2a1 | 2015-09-14 16:20:21 | [diff] [blame] | 30 | [style guide]: https://github.com/google/styleguide/tree/gh-pages/docguide |
agable | d40b954 | 2016-05-11 01:15:06 | [diff] [blame] | 31 | [md_browser]: ../tools/md_browser/ |