GNOME Bugzilla – Bug 701881
[help] Port documentation to mallard
Last modified: 2020-03-10 11:56:34 UTC
I'm working to port documentation to mallard format, and refactor the way the documentation is presented. As first iteration I'm trying to have something similar than the current help. My branch is available at https://github.com/bmillemathias/nemiver/ and the branch is called "mallard-docs", if someone want to look at it.
Thank you for undertaking this! It's very appreciated. I see that you are not only moving the format to Mallard, but also enhancing the content of the documentation itself. This is much needed. When you feel you are ready, please do not hesitate to sent patches to nemiver-list@gnome.org for review an inclusion. I am thinking maybe you could start send patches to just do the conversion to mallard. Then when they are committed, send patches to improve the content, progressively? What do you think?
(In reply to comment #1) > I see that you are not only moving the format to Mallard, but also > enhancing the content of the documentation itself. This is much > needed. Actually my first intention was just to port the documentation to Mallard, but due to licensing issue (that I don't get that much) I couldn't use the verbatim wording, so I started from scratch. > When you feel you are ready, please do not hesitate to sent > patches to nemiver-list@gnome.org for review an inclusion. > Okay, I'm doing when I'm in idle mode, so it's likely it'll take months to complete. > I am thinking maybe you could start send patches to just do the > conversion to mallard. Then when they are committed, send patches to > improve the content, progressively? > > What do you think? Yep, that would be great, and Mallard fits that way of working perfectly well, as each section can be a page that you link to the guide above, but I would like to reach a milestone where the documentation is almost equal than the previous one.
The documentation is done, and located in the branch mallard-docs on GNOME git, so anyone can review it.
Hey Dodji, any news of that ? Regards
Closing all open Nemiver tasks as this project does not seem to be maintained anymore. Please see https://gitlab.gnome.org/Infrastructure/Infrastructure/issues/235#note_732192 for further information. Thanks!