Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hoodiehq/editorial

:orange_book: The home of the Hoodie Editorial Team
https://github.com/hoodiehq/editorial

Last synced: about 1 month ago
JSON representation

:orange_book: The home of the Hoodie Editorial Team

Awesome Lists containing this project

README 

        
# The Hoodie Editorial Team



:rocket: Welcome to the home of the Hoodie Editorial Team! :rocket:  

  

## What is [Hoodie](http://hood.ie/)?



[Hoodie](http://hood.ie/) is a global, __inclusive community__ built around supporting the __open source__ software development effort of enabling (and empowering) folks to be able to build applications for the web. It accomplishes this by serving as a complete backend for your apps; it works immediately “out-of-the-box”: __develop your frontend code, plug it into Hoodie’s frontend-friendly API and your app is ready.__



Hoodie can refer to both the software development project, and the broader community. For more information about both, visit [hood.ie](http://hood.ie/). :dog:



## What is open source?



[Open source software](https://en.wikipedia.org/wiki/Open-source_software) (commonly abbreviated as OSS) is computer software with its source code made available with a license in which the copyright holder provides the rights to study, change, and distribute the software to anyone and for any purpose. Open source software may be developed in a collaborative public manner, for example, by __hosting code on GitHub__ and __collaborative discussion on [Slack and IRC](http://hood.ie/chat/)__.



[Click here for more information on open source and open source culture](https://opensource.com/resources/what-open-source), and [here’s a helpful list of frequently asked questions](https://opensource.com/resources). 



## We are an inclusive community first



Hoodie is an open source project and community __“beyond software.”__ Our team strongly believes that open source, an integral component of modern technology, is changing the way people collaborate and create, and that extends far beyond the source code.  



Hoodie is built by an amazing and dedicated community consisting of developers and non-coding experts. It relies on strong values like diversity, empowerment and decentralisation. At its core Hoodie exists to empower people and make web development easier and more accessible to a wide range of people.



We require all participation within the Hoodie project and community to act according to a [Code of Conduct](http://hood.ie/code-of-conduct/). We ask you to follow these guidelines which help steer __our interactions__ and strive to keep Hoodie a positive, growing project and community and help us __provide and ensure a safe environment for everyone__.



## What does the editorial team do?



The Editorial Team is one of many talented teams that contributes to Hoodie’s success. __Our primary focus is Hoodies’ communication with the wider community.__ We want to keep community members up to date with what we are doing but also showcase it to everyone who has used/is using/wants to use Hoodie for their project. We want to make Hoodie as open as possible with their process and act as a source of inspiration to the larger Open Source community.



[Read our official Mission Statement here.](https://github.com/hoodiehq/editorial/wiki/Mission-Statement)



### Common editorial contributions

+ Plan and write blog posts on or around Hoodie, Hoodie releases, side projects, [TGIF](http://hood.ie/blog/webkit-resizer-tiny-compiler-tgif-77.html), [community member profiles](http://hood.ie/blog/Charlotte-Spencer-meet-the-hoodies-2.html), conference and meetup recaps, etc. :memo:

+ Solicit and curate contributions to our [blog](http://hood.ie/blog/) from the larger community. :mag_right:

+ Plan and manage our [Twitter account](https://twitter.com/hoodiehq), announce new content, help funnel support requests to the engineering team.

+ Add pictures of animals in clothing to our [Tumblr](http://meetthehoodies.tumblr.com/) :dog: :shirt:.

+ General ideas and suggestions for other ways to support Hoodie!



## How you can contribute



__If you already have an idea of what you would like to do__ please visit the [Issues section](https://github.com/hoodiehq/editorial/issues) of this repository. The [Issues section](https://github.com/hoodiehq/editorial/issues) is where we keep track of potential editorial contributions, requests for help, and general suggestions. 



Here are some of the issues we are working on :point_right: [![Stories in Ready](https://badge.waffle.io/hoodiehq/editorial.svg?label=ready&title=Ready)](http://waffle.io/hoodiehq/editorial) and  [![Stories in Progress](https://badge.waffle.io/hoodiehq/editorial.svg?label=In%20Progress&title=In%20Progress)](http://waffle.io/hoodiehq/editorial)



When claiming a task please do the following:



1. Find a task with the green `help wanted` label 

2. Claim this issue (`comment on the issue or assign yourself`)

3. Remove `ready` label, add `in progress` label

4. If possible, give an indication of the timeline :relaxed:



__If you are brand new to Hoodie__ check out our [contribution guide](http://hood.ie/contribute/). We’re looking for people of all sorts, so don’t be afraid to get involved. If you’re passionate about contributing to a great community, we want you! :gem:



__If you are brand new to open source (including GitHub)__ first, welcome! :tada: If you haven’t checked it out yet, [opensource.com](https://opensource.com/resources/what-open-source) has some very helpful introductory resources that will give you a good understanding of the premise of open source and its ecosystem. 



To be a Hoodie contributor, you will need a GitHub account (which is free for open source), [sign up here](https://github.com/join). To get familar with GitHub as an online tool, they have created several tutorials which you can find via [GitHub Guides](https://guides.github.com/).



You will also need to know [Markdown](https://daringfireball.net/projects/markdown/), a text-to-HTML conversion tool for web writers. GitHub provides a [Markdown tutorial](https://guides.github.com/features/mastering-markdown/), and Daring Fireball has a particular thorough resource on [Markdown Syntax](https://daringfireball.net/projects/markdown/syntax). 



__Please be assured you will not have to have any prior knowledge of code or development to be a Hoodie contributor, especially within the Editorial team.__



## How to use GitHub  



The way in which the Editorial team uses GitHub is a bit different from other areas on the Hoodie team. 



This repository (or collection) serves as the source of truth for the Editorial team. We use the repository in two ways:



+ __Documentation__ of processes and resources (such as our style guide, or templates for types of reoccuring writing contributions)

+ __Idea capturing__ of all editorial contributions through the [Issues section](https://github.com/hoodiehq/editorial/issues) of this repository



We do not publish anything live to the externally facing websites from this repository. This is a __safe place to learn, ask questions, and make mistakes.__ So breathe easy. :relaxed:



__Some GitHub basics__

+ [Contributing to Open Source on GitHub](https://guides.github.com/activities/contributing-to-open-source/)

+ [Mastering Markdown](https://guides.github.com/features/mastering-markdown/)

+ [Mastering Issues](https://guides.github.com/features/issues/)

+ [Understanding the GitHub Flow](https://guides.github.com/introduction/flow/)



## Becoming a Hoodie contributor



If you enjoyed contributing a first time to Hoodie, we’d love to have you onboard. :dog:  See the [Contribution Guide for the overall project at hood.ie/contribute](http://hood.ie/contribute/). Another great way to determine if you’d like to continue on the project is to see the [Hoodie project goals](http://hood.ie/about/) and also review the [project initiatives](http://hood.ie/initiatives/), which are areas of the project supported across the entire team. 



### So you want to be a contributor 



Once you have made a contribution via GitHub (completing an issue, mergine a PR (pull request), etc.) we would like to invite you to be a collaborator on the [Hoodie GitHub repository](https://github.com/hoodiehq). Please note, this is not an automated process, and requires one of the core maintainers to invite you – so if you are reading this and have __not yet been invited__, please get ahold of one of the folks mentioned below. 



Becoming a collaborator simply means that you gain __push__ access to projects across the repository. We ask that until you have become a regular collaborator, that you still follow a common review process typically referred to as using __pull requests__.



The __review process__ is begun by submitting a __pull request__ back to the original version (branch) of a repository. Many, many, many amazing tutorials have been created about the pull request process so I won’t recap that here, but instead point you to the [GitHub tutorial](https://help.github.com/articles/using-pull-requests/).



For Hoodie, pull requests need to be approved by __two other contributors__, before being merged into the project.



### Next steps



You’ve have made your first contribution to the Hoodie project! :tada:



You’ve been added as a collaborator! :sunglasses:



Now, what’s next?



This grey area of onboarding is one our team is looking to improve across the project so first – __please give as much feedback about this as possible__ (you can email Jenn right here) but know that it’s an area we want to make better.



There is a [Next steps](https://github.com/hoodiehq/editorial/issues?q=is%3Aissue+is%3Aopen+label%3A%22Next+steps%22) label in the [Issues section](https://github.com/hoodiehq/editorial/issues) for editorial contributions considered to be a little more involved than what we’d ask first time contributors to take on. Check those out to see if anything resonates.



### If not, please feel free, empowered, and highly valued to [make suggestions](https://github.com/hoodiehq/editorial/issues/new) for contributions you’d like to see on the project. Your brand new and completely unique perspective is incredibly important to shaping this project. 



## Other essential resources



### [Slack chat](http://hood.ie/chat/)

Please join the Hoodie project [Slack chat](http://hood.ie/chat/), because a lot of our discussion and reviewing happens in that place. It’s also a great place to ask questions, meet other contributors, and find out the latest goings on within the project. There’s a specific _#editorial_ channel there you’ll want to join. 



### [Editorial Wiki](https://github.com/hoodiehq/editorial/wiki)

Our [wiki](https://github.com/hoodiehq/editorial/wiki) is an ongoing effort to build resources making it easier for folks to contribute. Some resources you can find there include our [mission statement](https://github.com/hoodiehq/editorial/wiki/Mission-Statement), a [glossary of common terms](https://github.com/hoodiehq/editorial/wiki/Glossary-of-common-terms), and our [language style guide](https://github.com/hoodiehq/editorial/wiki/Hoodie-Language-Style-Guide). 



### [Editorial Calendar](https://docs.google.com/spreadsheets/d/1qwjNqe8oQ-3Wb1mLYmlm2PM1b35Xdin8TCl8LruhOX8/edit#gid=212241305)

Check out our [schedule of blog posts](https://docs.google.com/spreadsheets/d/1qwjNqe8oQ-3Wb1mLYmlm2PM1b35Xdin8TCl8LruhOX8/edit#gid=212241305) for the coming month (find the appropriate month tab at the bottom of the screen) to see what posts are coming up, and what ongoing contributions (i.e., weekly blog posts) are available to be claimed.



### [Code of Conduct](http://hood.ie/code-of-conduct/)

It cannot be stressed enough that __our community is based on mutual respect, tolerance, and encouragement.__ So please read the [Code of Conduct](http://hood.ie/code-of-conduct/) and familarize yourself with the dos and don’ts.



## Who to contact for help



A lot of our conversations happen here on GitHub in the [issue tracker](https://github.com/hoodiehq/editorial/issues), or in the [#editorial channel in Slack](http://hood.ie/chat).



If there’s something you’d like to talk about that you don’t think fits in either of those places, or you’d just like to have a more private conversation; please feel free to contact the following people:



- :sunglasses: Jenn Turner - [GitHub](https://github.com/renrutnnej), [Twitter](https://twitter.com/jennwrites),  

- :dog: Jan Lehnardt - [GitHub](https://github.com/janl), [Twitter](https://twitter.com/janl), 

- :computer: Charlotte Spencer - [GitHub](https://github.com/charlotteis), [Twitter](https://twitter.com/charlotteis),