Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Reformat new release repository template. #296

Draft
wants to merge 1 commit into
base: latest
Choose a base branch
from

Conversation

nuclearsandwich
Copy link
Collaborator

This is a start at addressing some of the feedback provided in #125

My objective in using a big issue template with lots of explanatory comments was to make the documentation as local to its use as possible without cluttering the resulting issue (after all, the submitter can't both read the formatted text and fill out the template at the same time). But as I iterate, I'm starting to think that Issue Forms and a link to guiding documentation would be easier to follow and result in stil cleaner issues than this format. So I may abandon this effort in pursuit of a wider refactor.

This is a start at addressing some of the feedback provided in #125

My objective in using a big issue template with lots of explanatory
comments was to make the documentation as local to its use as possible
without cluttering the resulting issue (after all, the submitter can't both read the formatted text and fill out the template at the same time).
But as I iterate, I'm starting to think that [Issue
Forms](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms)
and a link to guiding documentation would be easier to follow and result
in stil cleaner issues than this format. So I may abandon this effort in
pursuit of a wider refactor.
Copy link
Contributor

@moriarty moriarty left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is cleaner. It is also clearer having the instructions for the checkbox outside of the comment where they can be seen after opening the issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

2 participants