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

CONTENT: Additional copy for hood.ie/get-help #67

Closed
4 tasks done
jennwrites opened this issue Mar 2, 2016 · 16 comments
Closed
4 tasks done

CONTENT: Additional copy for hood.ie/get-help #67

jennwrites opened this issue Mar 2, 2016 · 16 comments

Comments

@jennwrites
Copy link
Contributor

Part of hoodiehq/hood.ie#234

:octocat: Starter Issue

We would like to take the opportunity to invite someone who did not yet contribute to Hoodie to work on this issue. Follow @YourFirstPR on Twitter for more of these issues across many open source projects ☺️


✏️ The Task

In preparation for the Camp Release we are trying to update the hood.ie site. This specific writing task involves adding content to the Hoodie “get help” page to flesh out the ways folks can get assistance or encouragement as they run into blockers or issues when contributing to the project.

  • Claim this issue (@rubymorillo)
  • Contact @gr2m or @janl and conduct a brief interview for context and process pointers.
  • Submit to @renrutnnej @Charlotteis or @janl for review (Google docs probably work best for this sort of thing)
  • You are done 👏 comment below that your content is ready for review 🎉

Ping us in the Hoodie Chat or on Twitter if you have any questions :)

@rubymorillo
Copy link

Hey team, I'd like to claim this issue!

@jennwrites
Copy link
Contributor Author

It's all yours @rubymorillo! Please let me know if you need any help to get started, or if you get stuck! ☺️

@rubymorillo
Copy link

Thanks @renrutnnej!

@rubymorillo
Copy link

Hey all,

@gr2m and I jumped on a call and discussed what to add and remove from the Get Help page to reflect Hoodie's community focus. Here's an overview of what was discussed:

  • Remove the "For Any Question You May Have" and "Learn How to Get Started" sections.
  • Expand on the "Do You Want to Contribute to Hoodie?" section to include:
    1. What should I do if I am blocked (not exact title)? Direct people to the Slack community and call out which channels they can direct their questions to.
    2. Encouragement: this part, I'll have to connect with @renrutnnej to see what this could potentially look like.
  • Include a question on how to report harassment/code of conduct violation. We'll inform folks of where they can direct their questions to (basically reiterating the first graf of the CoC) and also link out to the full CoC.

I should have a draft in for review within a week!

@rubymorillo
Copy link

Pinging @renrutnnej! Want to take a look at the proposed Get Help updates for review?

Notes from my convo with @gr2m and what the proposed changes were are provided in the comment above for background. Thanks!

@jennwrites
Copy link
Contributor Author

I just reviewed the Google doc and I think it looks perfect @rubymorillo. Thank you so much 🙌

I see the notes on encouragement above and I'm curious if you still needed direction on that since it seems somewhat vague to me here. ☺️

@gr2m
Copy link
Member

gr2m commented Mar 14, 2016

added a few minor notes. I think it’s great, thanks Stephanie!

@rubymorillo
Copy link

Awesome @gr2m I updated that language!

@renrutnnej re: encouragement language; yes, I definitely need help with direction. Any tips?

@janl
Copy link
Member

janl commented Mar 15, 2016

Remove the "For Any Question You May Have" and "Learn How to Get Started" sections.

I’m curious about the reasoning for this?

I imagine /get-help to be a place not only for people who want to work on Hoodie, but mainly for people who are using Hoodie and need help.

@janl
Copy link
Member

janl commented Mar 15, 2016

To clarify: I understand that we are shaping things to focus more on the camp release, which focusses on contributors, but I think we should have something for end-users under that URL.

@rubymorillo
Copy link

Perhaps @gr2m could better answer those questions, @janl? ^^^

@gr2m
Copy link
Member

gr2m commented Mar 15, 2016

yeah that was me :) The FAQ is not helpful it might rather confuse at the moment, as the most new people will look into the new Hoodie. The Report a bug link eventually links to FAQ, too, and list of known bugs is also confusing.

Maybe we can add a section back in for Hoodie users, but only tell in there that we are working on a new version, that documentation might be outdated and that the best way is to come to the chat, something like that?

@rubymorillo
Copy link

@gr2m @janl I added a "Have questions about using Hoodie?" section for end users. Let me know what you both think!

@gr2m
Copy link
Member

gr2m commented Mar 23, 2016

We can put the "Have questions about using Hoodie?" first I’d say, it’s very short anyway. But this is good to publish for me either way :) Thanks @rubymorillo

@rubymorillo
Copy link

@janl done, move it up top!
@renrutnnej it's ready to go live!

@gr2m
Copy link
Member

gr2m commented Mar 26, 2016

done via hoodiehq/hood.ie#265 👏

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

No branches or pull requests

4 participants