On Sat, Jan 08, 2022 at 11:24:35AM -0500, Matt wrote: > Let me walk through what that looks like from my perspective. I'm afraid, > however, that it comes across as aggressive, ungrateful, or demanding. None > of those are my intent! I genuinely want to help but struggle to understand > the process. My goal is to outline a "user story". > > From my perspective, contributing to the cookbook looks as follows. I've > tried to be factual and ask rhetorical questions. > > How do I contribute to the cookbook? I see no information in the cookbook > about how to do that. I'm looking at > https://guix.gnu.org/cookbook/en/guix-cookbook.html > > The contribute page (https://guix.gnu.org/en/contribute/) links to this > mailing list. I am willing and ready to contribute. Now what? > > I see the manual has a section on contributing: > https://guix.gnu.org/manual/en/html_node/Contributing.html#Contributing > > I see nothing about how to contribute to documentation. > > Do I need to submit a patch? > How do I submit a patch? > Do I have to write in TexInfo? > What is the roadmap from me spending hours authoring something to it being > available for review from experts or to being useful to others?
I see that this all seems confusing. If you have something to contribute, you should just mail it to this list or guix-patches. Definitely, we prefer you send patches, but if that is too hard, you can send your contribution in *any* form.
