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
Agreed on hackmd not being an ideal tool. However, I really liked the realtime collaborative aspect of it, as well as the fact could be (pre)viewed online with no build setup.
Ideally, and this is very far away, we could create a similar web-based client for Natron, just for specifically editing rST, and once users edit the docs, then their changes are automatically sent via PR to Natron’s GitHub. I have an idea or two about implementation, and I’ve tried out something similar, but it is something very far away for sure.
We can keep hackmd for interactivity. For example tracking todo’s. But I think a better short time option would be to use a free account on an kanban website. What do you think ? (I’ve created one for my own todo list)
Kanban would be better, yes. Github also has a “projects” feature which is very similar to kanban and is good for project tracking (maybe even better because it can be directly tied to Github issues and PRs).
Hackmd for now is just a mirror site for easier collaboration, and for new contributors who don’t know the rST syntax to easily write things down. It has always required a manual contributor to actually convert hackmd’s markdown into properly-formatted rST (which is why pandoc doesn’t cut it), so it is by no means a primary option, but it should still be there for new contributors who don’t know rST to be able to contribute.
Now we have to manage shared access to this. My understanding is that we should replicate this on NatronGithub account and Fred would manage access rights, am I right ?