From 5f84196f1b1f17e10ff839266f4e81aaa3d081c6 Mon Sep 17 00:00:00 2001 From: Romain Bazile Date: Mon, 28 Sep 2020 11:45:44 +0200 Subject: [PATCH] documentation edition guide --- docs/edit_this_doc.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/edit_this_doc.md b/docs/edit_this_doc.md index bd5b72d..30299f9 100644 --- a/docs/edit_this_doc.md +++ b/docs/edit_this_doc.md @@ -1 +1,11 @@ -Here, there will be a guide to help edit this documentation +This documentation is hosted by [ReadTheDocs.org](https://readthedocs.org/) at https://planktonscope.readthedocs.io/. + +The source files are in the main [github repository](https://www.github.com/PlanktonPlanet/PlanktonScope), in the `docs` folder. + +They are simple [Markdown files](https://www.markdownguide.org/), that you can edit in any text editor of your choice. + +The local development and test is made using [mkdocs](https://www.mkdocs.org/). This allows you to test your documentation changes for styling issues and see what it will look like once rendered. + +If you want to include pictures and diagrams in the documentation, please set the pictures in a dedicated folder to the name of the page you are creating (for example, if your page is named `expert_setup.md`, please put all the related pictures in the `docs/expert_setup/` folder). Each picture should be named with a simple yet descriptive name, using jpg or png format if possible. Try to limit the size of the file by limiting the resolution to what is necessary for the picture to be clear on screen. + +Contributions should be made by creating pull requests on [Github directly](https://github.com/PlanktonPlanet/PlanktonScope/pulls). \ No newline at end of file