From 5cf448aa8cabbe3114383fcb129814691a6f5564 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Allan=20Nordh=C3=B8y?= Date: Tue, 24 Nov 2020 12:49:41 +0000 Subject: Contribute to the Remmina documentation reworked --- .../Contribute-to-the-Remmina-documentation.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) (limited to 'Contribution/Contribute-to-the-Remmina-documentation.md') diff --git a/Contribution/Contribute-to-the-Remmina-documentation.md b/Contribution/Contribute-to-the-Remmina-documentation.md index ceff3b6..b6262e7 100644 --- a/Contribution/Contribute-to-the-Remmina-documentation.md +++ b/Contribution/Contribute-to-the-Remmina-documentation.md @@ -1,16 +1,16 @@ -Remmina lacks a good usage and development documentation. +Remmina lacks good usage and development documentation. ## Usage documentation -In the future we would like to have an offline user manual generated out of the Wiki, therefore it's important to get a useful and updated wiki ASAP. +In the future we would like to have an offline user manual generated out of the wiki, therefore it's important to get a useful and updated wiki ASAP. -To contribute the Wiki you can either edit an existing page, or create a new one. +Contribute to the wiki you either editing an existing page, or creating new ones. -To create a new page click on [New page](https://gitlab.com/Remmina/Remmina/-/wikis/new), in the title specify the relative path of the page you want to create. +To create a new page, click [New page](https://gitlab.com/Remmina/Remmina/-/wikis/new), in the title specify the relative path of the page you want to create. -For instance if you want to create a page "How to share your local printers" under the Usage section, you will set the title as `Usage/How-to-share-your-local-printers`. +For instance, if you want to create a page on "How to share your local printers" under the Usage section, you will set the title as `Usage/How-to-share-your-local-printers`. -When you are done update the sidebar links https://gitlab.com/Remmina/Remmina/-/wikis/_sidebar and the section page (e.g. https://gitlab.com/Remmina/Remmina/-/wikis/Usage). +When you are done, update the sidebar links https://gitlab.com/Remmina/Remmina/-/wikis/_sidebar and the section page (e.g. https://gitlab.com/Remmina/Remmina/-/wikis/Usage). That's all! @@ -18,10 +18,10 @@ If you prefer to work from a terminal, the wiki can be [cloned](https://gitlab.c ## Developer documentation -We try to document the code as much as we can, but often we lack the time and/or some quick fixes would require documenting a large amount of code. +We try to document the code as much as we can, but often lack the time and/or some quick-fixes would require documenting a large amount of code. -If you are writing new code try to document it. If you are not a developer, but would like to learn, documenting the code is a hard but extremely effective way to learn. +If you are writing new code, try to document it. If you are not a developer, but would like to learn, documenting the code is hard, but an extremely effective way to learn. -We use Doxygen, the documented code is automatically deployed on https://remmina.gitlab.io/remminadoc.gitlab.io/ , a good example, if you don't have Doxygen experience is https://gitlab.com/Remmina/Remmina/-/blob/master/src/remmina_stats.c, that renders as https://remmina.gitlab.io/remminadoc.gitlab.io/remmina__stats_8c.html +We use [Doxygen](https://www.doxygen.nl/index.html), the documented code is automatically deployed on https://remmina.gitlab.io/remminadoc.gitlab.io/ , a good example, if you don't have Doxygen experience is https://gitlab.com/Remmina/Remmina/-/blob/master/src/remmina_stats.c, that renders as https://remmina.gitlab.io/remminadoc.gitlab.io/remmina__stats_8c.html Don't be afraid and/or lazy and ask for help in our IRC channel if you have troubles. \ No newline at end of file -- cgit v1.2.3