On 25/08/2022 15:28, Robby Callicotte via CentOS-devel wrote:
On Thursday, August 25, 2022 8:46:18 AM CDT Neal Gompa wrote:
I second this. Our quick docs could use MkDocs like the SIG stuff does, and the RHELish stuff can use the Antora system the RHEL docs folks want to use.
I agree with Neal here. This seems to offer a good balance. At this point I would argue that the MR/PR nature of git is ubiquitous and is part of everyone's workflow.
So far I've seen lots of "yes, use this" type comments so I'd like to ask how this compares in user friendliness to the current wiki (assuming that you can get to it because the spammers are taking a rest). I've never used any of the alternatives that have been proposed so far. Are they wikis? Are they usable for a non-technical user? The wiki, you press a button and you can edit content directly and see what it will look like before you save it. You can link to other pages easily, you can format content how you want it easily, often just at the press of a button.
None of what I've heard so far sounds even remotely as usable as what we have now.
Trevor