search

hoodiehq / editorial

:orange_book: The home of the Hoodie Editorial Team
MIT License
23 stars 7 forks source link

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

Closed jennwrites closed 8 years ago

jennwrites commented 8 years ago

Part of https://github.com/hoodiehq/hood.ie/issues/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 :relaxed:

:pencil2: 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.

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

rubymorillo commented 8 years ago

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

jennwrites commented 8 years ago

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

rubymorillo commented 8 years ago

Thanks @renrutnnej!

rubymorillo commented 8 years ago

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:

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

rubymorillo commented 8 years ago

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 commented 8 years ago

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

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. :relaxed:

gr2m commented 8 years ago

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

rubymorillo commented 8 years ago

Awesome @gr2m I updated that language!

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

janl commented 8 years ago

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 commented 8 years ago

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 commented 8 years ago

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

gr2m commented 8 years ago

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 commented 8 years ago

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

gr2m commented 8 years ago

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 commented 8 years ago

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

gr2m commented 8 years ago

done via https://github.com/hoodiehq/hood.ie/pull/265 :clap: