Skip to content

Commit

Permalink
Merge pull request #72 from basho-labs/next-release
Browse files Browse the repository at this point in the history
Merging v1.0 - it's time to continue to evolve this project.
  • Loading branch information
mbbroberg committed Aug 29, 2015
2 parents df2f274 + 3264073 commit 1bfe8e5
Show file tree
Hide file tree
Showing 12 changed files with 71 additions and 497 deletions.
82 changes: 57 additions & 25 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,49 +1,81 @@
##The Riak Community
##The Basho Community


There are many components to a successful open source software project. Code (and code quality) is only the first of many, and lot of times it's not the most important (for better or for worse). **A Community** is built around the code to help foster its growth, maturity, and adoption. Like the code, it **needs to evolve**, and unless it's moving forward and being refined continuously, it ceases to be valuable.

If you’re looking to get more involved in our community, we’d love to have you. You can connect with your fellow members [on IRC](http://webchat.freenode.net/#riak), on the [riak-user list](http://lists.basho.com/mailman/listinfo/riak-users_lists.basho.com) or [in-person at meetups](http://www.meetup.com/pro/basho/).


### The Goal

We've introduced the idea of "The Riak Community" as a releasable product. Why not approach community development like you would code? What if there were scheduled "releases" comprised of new "features" and "bug fixes"?

The idea is simple: each few months we cut a "new release" of the Riak Community. A release will be comprised of updates to **how we communicate**. The more detailed conversation can occur as [release notes](https://github.com/basho-labs/the-riak-community/tree/master/release-notes). If you would like to contribute something to a past or future release, the overly-complex process is [here](#contributing).
Culture is most powerful when chosen intentionally. Let's choose what type of community we wish to be.

The goal is to periodically tag and release "versions" of The Riak Community. This tagging will signify specific objectives, both internal to Basho and external in our Community. Culture is most powerful when chosen intentionally. Let's choose what type of community we wish to be.
We've introduced the idea of "The Basho Community" as a releasable product. Why not approach community development like you would code? What if there were scheduled "releases" comprised of new "features" and "bug fixes"?

Each subsequent release will represent the evolution of the Community: new docs will have been written; new talks will have been given; new slide decks will have been created; process flaws will have been unearthed and rectified. All of this moves the community forward and makes it a better place to work and play.

Finally, this will be a way for us to track the progression of the community over time and build the community in a more collaborative, transparent way. There are people all over the world contributing to the growth of Riak in endless ways. This is an attempt at capturing and showcasing that growth.
The idea is simple: every few months we cut a "new release" of the Basho Community. A release will be comprised of updates to **how we communicate**. The more detailed conversation can occur as [Issues](https://github.com/basho-labs/the-riak-community/issues).

### What Should Be Part of a Riak Community Release?
The goal is to periodically tag and release "versions" of The Basho Community. This tagging will signify specific objectives, both internal to Basho and external in our Community.

For the purposes of this project, a community release can include anything that's not code specific to Riak products, though work related to code (e.g. releasing a new client library definitely counts). Anything that contributes to the advancement of the community as a whole. A partial list of examples:
Each subsequent release will represent the evolution of the Community: new ways to share our code, new ways to communicate more clearly, process flaws will have been unearthed, and rectified. All of this moves the community forward and makes it a better place to work and play.

Finally, this will be a way for us to track the progression of the community over time and build the community in a more collaborative, transparent way. There are people all over the world contributing to the growth of the Basho Community in endless ways. This is an attempt at capturing and showcasing that growth.

* A blog post about your team's Riak usage
* A presentation at a local meetup and accompanying slide deck
* Releasing your PHP ORM and open sourcing it
* Documentation you contributed for the Python client
* A screencast Basho made to show new Riak Search features
* The 30 minutes you spent in the Mailing List to help a newcomer
* Adding the [Powered By Riak badge](http://docs.basho.com/riak/1.0.0/references/appendices/community/We-Run-Riak-Badges/) to your site

### Release Cycles and Versioning

Since community as code will be driven by feel over functionality, we probably won't get too in-depth with the versioning and release cycles. For now:

* A new release of The Riak Community will happen on the first work day of each month (time and resource-permitting)
* Each new version will be a minor version increase (i.e. "v0.2" will follow "v0.1")
* A new release of The Basho Community will happen as significant changes to our communication processes occur
* Each new version will be a minor version increase as we make minor improvements (i.e. "v0.2" will follow "v0.1")
* A combination of new major programs and new processes may justify a major release (i.e. "v2.0" could follow "v1.6")

### Contributing

1. Open a [pull request](https://github.com/basho-labs/the-riak-community/pull/new/master) with details on your (or someone else's) contribution. Your contribution should be added to the appropriate [release notes](https://github.com/basho-labs/the-riak-community/tree/master/release-notes) (they are all dated) and should be a short description of what you're adding with a link to related materials.
2. Someone with commit rights to the repo will close the PR and you and your contribution will be added to the forthcoming Riak Community Release.
1. Open an [Issue](https://github.com/basho-labs/the-riak-community/issues) as you have ideas for community improvement. These may be as general as requests for visibility ([example](https://github.com/basho-labs/the-riak-community/issues/69)) or as specific as request for coordinated improvements ([example](https://github.com/basho-labs/the-riak-community/issues/71))
2. Open a [pull request](https://github.com/basho-labs/the-riak-community/pull/new/master) with details on your ideas for improvement or corrections to existing information
3. Someone with commit rights to the repo will discuss the details over the PR

#### Labels

You'll notice a detailed list of labels on our issues here (inspired by Docker). The major topics are broken out into 3 buckets:

* **Capitalized** - manually applied labels that indicate an important status
* **requests** - track requests for types of projects, from a how-to guide to a presentation
* **status** - gets people's attention and clarify who's running with what

Here is what they all mean:

* `Open Discussion` - designed to be a conversation. This tag makes sense on early requests that need clarification of scope and community-centric discussions like organizational structure on GitHub itself
* `Next Release` - a soft indication that this issue has a time limit target on it
* `Ending Soon` - a hard indication that this issue is about to close (less than 2 weeks)
* `Taishi` - a project; more on this at a later time
* `request/blog` - request for a specific blog by Basho or Community members
* `request/demo` - request for a demo project, prototype or similar work
* `request/event` - request to host, sponsor or contribute a speaker to a specific community event
* `request/howto` - request for a detailed, step-by-step how-to that is not already tracked in our [documentation](https://github.com/basho/basho_docs)
* `request/maintainer` - the need for a maintainer on an existing Basho Labs project
* `request/slides` - the request for a new presentation or copy of a past presentation
* `status/0-triage` - TBD; targeted to track progress of technical work
* `status/1-design-review` - TBD; targeted to track progress of technical work
* `status/2-code-review` - TBD; targeted to track progress of technical work
* `status/3-docs-review` - TBD; targeted to track progress of technical work
* `status/4-merge` - TBD; targeted to track progress of technical work
* `status/claimed` - the idea that a community contributor can own the completion of a specific project
* `status/help-wanted` - indicator that the `claimed` project needs a helping hand to keep it going
* `status/needs-attention` - indicator that a project is getting stale and deserves more attention by us all

## Maintainers / Thanks
This project began with [Mark Phillips](https://twitter.com/pharkmillups) and was continued by me, [Matt Brender](https://twitter.com/mjbrender). I would like to keep it in mind as we reflect on the next steps for the Open Source ecosystem that Riak is a part of. Please send your thoughts to [community@basho.com](mailto:community@basho.com).

Thanks to those who have contributed in 2015:

* Daniel Dreier (<https://github.com/danieldreier>)
* Seth Thomas (<https://github.com/cheeseplus>)
* Lauren Rother (<https://github.com/laurenrother>)

## License

## Thanks
This project began with [Mark Phillips](https://twitter.com/pharkmillups) and it was quiet for a few years after that. I would like to keep it in mind as we reflect on the next steps for the Open Source ecosystem that Riak is a part of. Please send your thoughts to me, [@mjbrender on Twitter](https://twitter.com/mjbrender) or to [mbrender@basho.com](mailto:mbrender@basho.com).
Feel free to use this format in your own community.

We'll see how this goes. It might fail miserably, but I don't think it'll be a total disaster. Also, if you think this idea is ruining the internet, or if there is a way to do this more effectively, please share with us.
Licensed under the [Apache License][LICENSE], Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
113 changes: 0 additions & 113 deletions release-notes/riak-community-0.2.md

This file was deleted.

0 comments on commit 1bfe8e5

Please sign in to comment.