Add a /for/contributors/ page #1135
Conversation
In conversation with @ceboudreaux in [IRC](https://botbot.me/freenode/gittip/msg/4258008/) and @heidigardner on #1120, it came out that Gittip has many sources of information and it's hard to get oriented as a new contributor. Here's a page that aims to fix this problem.
|
An excellent start! "Gittip is a new kind of company" <-- I would say "new kind of organization." "and everyone who volunteers gets a share of the money that has been given to Gittip" <-- Need to define what constitutes a share. Maybe like "self-allocated portion." "share of the money" link is broken. "SOURCES OF TRUTH" <-- Change truth to communication. Not all communication is truth. "Here's where Gittip gets defined, most important to least:" IRC is more important than Github?? I think we should omit this line altogether. Oral Tradition <-- I don't think this is the appropriate label. Medium / Tinyletter <-- Specify that this is the EMAIL newsletter. |
|
We have the "open company" term used and described elsewhere. Maybe link to: http://blog.gittip.com/post/26350459746/the-first-open-company the link to members is currently on "share of the money," but would be more accurate on "everyone who volunteers." Though it might be even more accurate to say "Members of Team Gittip" (link to members), "Share of the money" (link to medium post) and then have a "Here's How to become a Member" statement and link! "Here's where Gittip gets defined" >>> "Here's where Gittip is being defined . . . " "Oral Tradition" doesn't strike me as wrong-- only because it helps take away the expectation on the part of the reader that there is any "one" source for information. (Until the day that there is. mwhahahahaah.) So while it still gives me hives that we can't feed all these streams of communication into one place, this is certainly a nice balm. Thanks, Chad! |
Per feedback from @heidigardner and @ceboudreaux. - "new kind of company" -> "new kind of organization" - change "share" to "take" to indicate method of distribution - add two links and move a third
Done. Is this because Gittip isn't a company, or ... ?
Changed to "gets to take some of the money." How's that?
Good call. Done.
Done. |
@ceboudreaux Try now? (Note that it's the "everyone who volunteers" link now.) |
@ceboudreaux Done. |
Took out that line entirely.
I changed "Sources of Truth" to "Where Does Work Happen?" and dropped 0. Oral Tradition entirely. I think it's still clear enough that there are many places where conversation happens. I added two more sections: "How Is Work Divided?" and "Where Do I Start?" You'll notice that the departments under "How Is Work Divided?" are links. The plan is to fill out those pages with top-level descriptions of the workflows for each department to a) help new members see what they're getting themselves into, and b) keep current members focused. I added "Where Do I Start?" because I thought we needed a call to action. http://gittip-qa537.herokuapp.com/for/contributors/ How are we doing? |
|
Looking great! |
|
Placemat notes for department pages: |
Add legal and accounting
|
Where is this page going to live on the internet? Will it be a link on our About page? |
|
It's going to live at https://www.gittip.com/for/contributors/. I figured we'd link it from the About page, yeah. It's designed to replace the "Get Involved" section there. No? |
ghost
assigned I dropped the "types of work" verbiage for now. Let's get this out the door and then revisit how best to get business process documentation on there.
|
@ceboudreaux @heidigardner I'm ready for final review/merge on this. I took out the "departments / types of work" copy because that's a deeper rabbit hole and this is a meaningful enough change to make as it stands. I've got some ideas for "types of work" and I'll start a new PR for that. I changed up the about page to point to the new contributors page. Compare here: https://www.gittip.com/about/ The next step is for one of you to decide that this is good enough, and hit the "Merge pull request" button and step through that workflow. :-) |
We don't "do work" on Twitter, Facebook, or Tumblr. Those are ways we communicate with the general public, but not ways we communicate with each other as work.
Aligned contact us right (?!), changed call to action under get involved (clicking the link doesn't make you a contributor).
|
Here's what @ceboudreaux is looking for: <:-] |
|
|
|
👍 As a new contributor, all of this information is useful and interesting. |
|
@icco Yay! :D |
Add a /for/contributors/ page
@ceboudreaux and @heidigardner have both pointed out that there are a lot of sources of information about Gittip, and as a new contributor it's hard to know where to begin. Here's a page in the new overloaded
/for/namespace (see #949; we use/for/for communities, and I'm now proposing that we also use/for/for high-level pages targeting specific user groups such as companies and nonprofits).With this pull request and #1134 I'm trying to move more to a model where I don't make changes to master directly, but rather I submit pull requests. This is a best practice and also opens up the field to other contributors participating as equals rather than me exercising special privileges. Hopefully over time that helps with team building. :-)
Also with this pull request, I've hand-rolled a QA instance of the app at Heroku so that non-technical contributors can view the changes on this branch without having to stand up the app themselves. I think we can greatly tighten our feedback loop if we streamline that process (#1133). Anyway, you can see the rendered page in this pull request here:
http://gittip-qa537.herokuapp.com/for/contributors/