3 commits

Author	SHA1	Message	Date
Ilya Grigoriev	adc8433204	mkdocs: make MkDocs work with more GitHub-like list formatting ... This adds two MkDocs extensions to make list handling more flexible. It took some trial-and-error, but it seems this config works OK. revsets.md: use saner formatting that is now possible. sapling-comparison.md: this was the one case I saw made worse by the new plugins. I changed the Markdown formatting, it still looks sane.	2023-11-03 19:15:37 -07:00
Ilya Grigoriev	2218143968	docs: create a basic homepage for the docs website ... Before, https://martinvonz.github.io/jj/latest redirected to https://martinvonz.github.io/jj/latest/install-and-setup.html. Now, it will direct people to a basic page with a link to the repo and a few other useful pages. An additional motivation is the desire to have a homepage to link to from https://github.com/martinvonz/jj/pull/2273#discussion_r1331008117. Better something very basic than nothing.	2023-10-03 19:58:22 -07:00
Ilya Grigoriev	fc49258d2f	docs: Set up mkdocs and poetry ... I initially was thinking of using `mdbook`, which looks a little better, but I think versioning the docs is important, and the features I want are pretty much only supported by the Mkdocs' "Material" theme. Mkdocs is written in Python. The prerequesites for building docs on your machine should be to install Python and Poetry, everything else should be installed automatically by Poetry. See the edits to `contributing.md` for more details.	2023-08-28 10:43:48 -07:00