Hello, [email protected] skribis:
> The friction to participate in the Cookbook is too high in my > opinion. The sheer fact that you must open a pull request and iterate > on reviews is a friction that either stops a lot of people or make > them publish elsewhere. If you add the needed knowledge of texinfo > (even if only perceived and not real) this is just a blocker. As as been said before, we accept contributions in formats other than Texinfo, but perhaps that is not clear enough. If reviews are a blocker, then, in a way, it’s working as intended: reviews exist to consolidate knowledge together. Of course, we want them to be a lightweight and quick as possible for the Cookbook, but that there are reviews is on purpose. Reviews are the one thing that wikis typically lack. If it is this kind of friction we’re talking about, I’m personally fine with it. I think we owe to make that effort on documents that people using Guix will read. I’m also not sure friction to contribute alone explains why many prefer to post how-tos on their personal blog post—we accept contributions to https://guix.gnu.org/blog (Markdown!) as well, and they are sometimes a starting point for new sections of the Cookbook. Bottom line: it’s okay that people post how-tos on their own sites, it’s even the sign of a healthy growing community. To me the question is more about the level of quality assurance we want for the “official” documentation. Ludo’.
