On Sat, 6 Jun 2020 06:40:43 -0500 Richard Shaw <hobbes1069@xxxxxxxxx> wrote: > On Sat, Jun 6, 2020 at 5:54 AM Andy Mender <andymenderunix@xxxxxxxxx> > wrote: > > As someone who just recently started out with packaging and has a > > fresh view on the problem, I would be more than happy to help out > > with the docs :). > > > > YES PLEASE. Documentation isn't necessarily and afterthought, but > it's not "fun" and not many people want to do it. It is *hard*. Good documentation requires an intimate knowledge of the system, and all the permutations it can exhibit. Writing about that is not a slap dash onto the page / screen if it is going to be useful for both beginners and old hands, it is *work*. Read some of the official documentation manuals for proprietary software: turgid and exhaustive, with excruciating detail. Add Fedora's high rate of change, and it becomes understandable why documentation is lagging. That rate of change doesn't make documentation less useful, though, rather the opposite. So, needed more, provided less => high barrier to entry. _______________________________________________ devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/devel@xxxxxxxxxxxxxxxxxxxxxxx
