Improving new Recipe onboarding #571

Open
opened 2024-02-12 15:57:18 +00:00 by basebuilder · 3 comments
Member

In the recipes-wishlist I created .gitea/issue_template/recipe.md so people filing issues get a nice little text when adding a new Recipe Wish. Similar to this organising repository.

Screenshot 2024-02-12 at 16-44-34 recipes-wishlist.png

The template also prepopulates the issue with the markdown which ends up in the README.md file in the future recipe. To see this text click here.

This might not be best template text. But I figured when looking at the issues people are filing, things could be made more explicit structured as it will slightly reduce work for maintainers.

In the [recipes-wishlist](/coop-cloud/recipes-wishlist) I created `.gitea/issue_template/recipe.md` so people filing issues get a nice little text when adding a new Recipe Wish. Similar to this `organising` repository. ![Screenshot 2024-02-12 at 16-44-34 recipes-wishlist.png](/attachments/cc9a8c45-4f92-4b5d-92dc-e7e348c3c4c3) The template also prepopulates the issue with the markdown which ends up in the `README.md` file in the future recipe. To see this text [click here](https://git.coopcloud.tech/coop-cloud/recipes-wishlist/issues/new?template=.gitea%2fissue_template%2frecipe.md). This might not be best template text. But I figured when looking at the issues people are filing, things could be made more explicit structured as it will slightly reduce work for maintainers.
basebuilder added the
contributing
label 2024-02-12 15:58:10 +00:00
Owner

Seems a bit much for a wishlist template tbh. I thought the format of coop-cloud/recipes-wishlist#26 was pretty accessible. Being a maintainer is hard but also you're in a better position to answer those metadata questions after you've been in the config trenches. Might scare people off throwing in good recommendations? Some thoughts.

Seems a bit much for a wishlist template tbh. I thought the format of https://git.coopcloud.tech/coop-cloud/recipes-wishlist/issues/26 was pretty accessible. Being a maintainer is hard but also you're in a better position to answer those metadata questions after you've been in the config trenches. Might scare people off throwing in good recommendations? Some thoughts.
Author
Member

Seems a bit much for a wishlist template tbh

Yah, I agree. I was a bit carried way. Thanks for the sanity check 🤣

> Seems a bit much for a wishlist template tbh Yah, I agree. I was a bit carried way. Thanks for the sanity check 🤣
Owner

I also went absolutely wild on the Gitea templates when I first found them. Then I deleted them all 🙃 With great power comes unexpected waves of galaxy brain impulses. Dog bless us all.

I also went absolutely wild on the Gitea templates when I first found them. Then I deleted them all 🙃 With great power comes unexpected waves of galaxy brain impulses. Dog bless us all.
decentral1se added the
documentation
label 2024-03-27 06:19:08 +00:00
Sign in to join this conversation.
No Milestone
No project
No Assignees
2 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: coop-cloud/organising#571
No description provided.