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

Convert Suggest a guide Template to Github Form Issue #128

Open
8 tasks
adrian-zaragoza opened this issue Sep 21, 2021 · 3 comments
Open
8 tasks

Convert Suggest a guide Template to Github Form Issue #128

adrian-zaragoza opened this issue Sep 21, 2021 · 3 comments

Comments

@adrian-zaragoza
Copy link
Member

adrian-zaragoza commented Sep 21, 2021

Dependency

  • This is on hold until we figure out the whole workflow process for guides.
  • until MVP is ready to launch

Overview

As an issue creator, we want to implement issue templates for issue creation to streamline and simplify the process. The current issue forms require the person to replace the text, and is less user-friendly compared to GitHub Form issues.

Action Items

  • Define the form elements and their behavior
    • Review with product and Front End Lead
  • Create a suggest-a-guide.yml file in your own fork in: gh-pages/.github/ISSUE_TEMPLATE
  • Follow github form syntax readings below to code a similar form to the current issue template.
  • Get Signoff by Product on the proposed template before making a PR
  • Delete suggest-a-guide.md file in this folder

Resources/Instructions

Current Issue Template Code File
Github Forms Issue Reading
Github Forms Issue Reading Pt 2
hackforla/website#2128

To get signoff from product: put your issue in the Review column on the project board.

@github-actions
Copy link

Hi @adrian-zaragoza.

Good job adding the required labels to this issue.

Just a friendly reminder to also move the issue into the "New Issue Approval" column under the Project Board. For more info on that, check Github's documentation here.
Thanks!

Additional Resources:
Wiki: How to add status labels to issues (WIP. Link will be updated when the wiki is done)
Wiki: How to create issues (WIP. Link will be updated when the wiki is done)

@ExperimentsInHonesty
Copy link
Member

This issue is about using the native github forms making tool to make issues easier to fill out. We could use it to allow people to suggest guides. Here is an example of an issue template that uses it.

You still have to have a GitHub account to open an issue.
Which works for people inside hackforla,
Which does not work for those outside

A different option is to reference a google form and have it automatically make issues like this example does
form: https://forms.gle/BJ5p8rZuYPW729KD9
Repo/column it makes the new issue on: https://github.com/100Automations/futureautomations/projects/1#column-12391556
Which works for people both inside and outside the organization
however it does not show the github handle of the author, instead its a bot, so harder to follow up with the person who suggested the guide. Also, if we are asking them for their email, it would be displayed on the issue, which is not all that secure.

@ExperimentsInHonesty
Copy link
Member

This issue needs to be cleaned up or used as a starting point. We are going to need a suggest a guide function, but it should check to see if there is already a guide in progress for that, before allowing you to suggest. Then it should ask specific questions that have not yet been determined.

Adding this to the guides icebox until MVP is ready to launch

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: Needs to be Triaged
Development

No branches or pull requests

4 participants