I agree that it is hard for non-programmers to get started on things like a version control system; indeed I am myself a programmer, and I still find it intimidating to contribute to Natron’s massive codebase!
I’ve hosted a simple editable wiki here: https://hackmd.io/@4Hwha1m4Tgm-uIGs2O6kwg/SkdrzENDO/edit. It is formatted with markdown which has a really simple syntax. I can merge this periodically into the main Natron docs, and there are a plethora of markdown to rst converters out there. If you have time to, feel free to add to the docs there.
I’m starting to make screenshots for the documentation. Does anyone know if a new skin of Natron is currently worked on ? If so I would need a beta version to avoid the docs feeling outdated pretty soon.
@bonalex01 Thanks for your great work! Though syncing directly to Github would be nice, the main issue is that Natron’s docs are in RST format, while HackMD is markdown. Converting between the two formats is trivial with a bit of shell scripting and pandoc, but I want to keep the two separately and manually add the WIP docs on hackmd to Natron’s repo one at a time to ensure that the main docs are clean.
I think the hackmd.io experiment is not successful for me because:
doesn’t deal with the important step of interlinking the different pages of the documentation.
it badly renames images
as we knew it requires translation from md to rst.
My new workflow:
Visual studio code
RestructuredText VSCode extension (provides sphinx compilation)
GIT publishing tools of VSCode to send the result strait to github