Various Chromium OS docs written in markdown with no other home!

Clone this repo:
  1. cdfcbd3 development_basics: Add Rust to the list of programming languages by Zach Reizner · 5 hours ago main
  2. 15d9bdb Added a pointer to a helpful README on uid/gid choices by Zi Lin · 5 hours ago
  3. 11101e4 sandboxing: clean up some references to legacy CQ by Jack Rosenthal · 6 hours ago
  4. 133249e docs: Update Crostini docs by David Munro · 15 hours ago
  5. e0bd438 Added missing ')' for the ARC column. by Shuba Jagannathan · 4 days ago

Chromium OS docs

This directory contains public Chromium OS project documentation that is automatically rendered by Gitiles. The docs are written in Gitiles-flavored Markdown.

General guidelines

See the Chromium documentation guidelines and Chromium documentation best practices.

Style guide

Markdown documents must follow the style guide.

Making changes

This repository is managed by the repo tool, so you can make changes to it using the same techniques that you'd use for any other repositories in the project.

See the Contributing guide for more details.

Making changes without repo

You can also make changes to this repository without using the repo tool. This comes in handy when you don't have a Chromium OS checkout:

git clone
cd docs
curl -Lo .git/hooks/commit-msg
chmod +x .git/hooks/commit-msg
git checkout -b changes
(make some changes)
git commit -a
git push origin HEAD:refs/for/master

The above steps will upload a patch to where you can get your patch reviewed, and submit.

Previewing changes

You can preview your local changes using scripts/preview_docs which utilizes Gerrit sandbox branches:


You can also use md_browser, which is entirely local and does not require refs/sandbox/ push permission, but has somewhat inaccurate rendering:

# at top of Chromium OS checkout
./src/chromium/src/tools/md_browser/ -d docs

Then browse to e.g. http://localhost:8080/

To review someone else's changes, apply them locally first, or just click the gitiles link near the top of a Gerrit file diff page.