From 870a58fde697ed1eb1e91bb1020f83ed8414d9ab Mon Sep 17 00:00:00 2001 From: Ilya Grigoriev Date: Fri, 8 Sep 2023 17:26:18 -0700 Subject: [PATCH] contributing.md: add section about contributing to the docs --- docs/contributing.md | 30 +++++++++++++++++++++++------- 1 file changed, 23 insertions(+), 7 deletions(-) diff --git a/docs/contributing.md b/docs/contributing.md index e7ecd6bfc7..9679c9e199 100644 --- a/docs/contributing.md +++ b/docs/contributing.md @@ -58,6 +58,27 @@ This project follows [Google's Open Source Community Guidelines](https://opensource.google/conduct/). +## Contributing to the documentation + +We appreciate [bug +reports](https://github.com/martinvonz/jj/issues/new?template=bug_report.md) +about any problems, however small, lurking in [our documentation +website](https://martinvonz.github.io/jj/prerelease) or in the `jj help` docs. +If a part of the bug report template does not apply, you can just delete it. + +If you are willing to make a PR fixing such a problem, even better. + +Before reporting or working on a problem with the documentation website, we'd +appreciate it if you could check that the problem still exists in the +"prerelease" version of the documentation (as opposed to the docs for one of the +released versions of `jj`). You can use the version switcher in the top-left of +the website to do so. + +You do not need to know Rust to contribute to the documentation website. See +below for [instructions on how to preview the HTML +docs](#previewing-the-html-documentation) as you edit the Markdown files. Doing +so is optional, but recommended. + ## Learning Rust In addition to the [Rust Book](https://doc.rust-lang.org/book/) and the other @@ -65,10 +86,6 @@ excellent resources at , we recommend the ["Comprehensive Rust" mini-course](https://google.github.io/comprehensive-rust/) for an overview, especially if you are familiar with C++. - - ## Setting up a development environment To develop `jj`, the mandatory steps are simply @@ -137,9 +154,8 @@ These are listed roughly in order of decreasing importance. ## Previewing the HTML documentation -The documentation for `jj` is automatically published to the website -. At the moment, this is experimental, -but we hope to advertise this website to our users soon. +The documentation for `jj` is automatically published to the website at +. When editing documentation, we'd appreciate it if you checked that the result will look as expected when published to the website.