I think that it could be useful to have like a hugo recipe book, with several pieces of code that you end up using all the time. For example, I’ve seen that many people have similar questions about taxonomies. Since I created little repo dedicated to the use of taxonomies, a couple times, helping people has been as easy as pointing them to those examples. So if we had a little recipe book, it would be easy to just point them to the snippet that best fit their needs.
I’ve been documenting several snippets and I use them for most of my projects. So I’ve found that it also helps me save some time.
You can find most of what you need in the docs. But people, specially non-developers, need more examples. And I think that if the docs were all filled with thousands of little examples, it could get very messy, unless there was a dedicated section just for snippets. For example, let’s say you have a snippet that combines .Scratch and taxonomies. Would that go in any of the 3 pages for taxonomies, or in the .Scratch page? That’s why I think that “recipes” need their own space.
So I have 3 questions:
- Is there anything similar already been worked on, and that I can contribute to?
- If not, is there anybody interested in having something like it?
- What would be a nice way to document all those snippets? I’ve been using gists and repos. But there must be an easier way to do it. Does it belong to the docs? Or outside the docs?