Skip to content

Commit

Permalink
Update how-to-run-a-maintainathon.md
Browse files Browse the repository at this point in the history
  • Loading branch information
gr2m authored Apr 12, 2019
1 parent 07a5c61 commit de8a739
Showing 1 changed file with 18 additions and 25 deletions.
43 changes: 18 additions & 25 deletions how-to-run-a-maintainathon.md
Original file line number Diff line number Diff line change
@@ -1,47 +1,40 @@
# Running a Nock Maintainathon: The checklist
# How to run a Nock maintainathon

We've been trying something different over the past few months - running a Nock maintainathon every now and then. This is something like a Hackathon, but minus the overnighting. Basically, we synchronize our watches and meet up at a set date to work on something that needs to be done in Nock, in order to make the entire program better. This helps us get out of the weeds of dealing with support issues; helps the maintainers meet each other and hang out; and helps us cultivate a sense of community.
We run a remote hackathon on every 2nd Friday of a month, at 12-4pm EST. Everyone is invited!

We've written several Medium posts on this process:
A Nock maintainathon is something like a hackathon, but minus the overnighting. Basically, we synchronize our watches and meet up at the same time to work on something that needs to be done in Nock, in order to make the entire project better. It’s also an opportunity to meet each other face to face.

- [Maintain-a-thon for Nock](https://medium.com/nodenock/maintain-athon-for-nock-3a2a0fe982a9)
- [The Nock roadmap: Where we are, and where we are going](https://medium.com/nodenock/the-nock-roadmap-where-we-are-and-where-we-are-going-8844df218649?source=collection_home---6------1---------------------)
- [The Nock Maintainathon: Success!](https://medium.com/nodenock/the-nock-maintainathon-success-f0f5ae07457a)

Here, we want to lay out the specific checklist that should be done in order to set one of these up.
If you plan to help hosting a Nock maintainathon, here is a check list:

### Prerequisites

You will need access to these things:

- The [@nodenock](https://twitter.com/nodenock/) Twitter account. Ask @gr2m or @RichardLitt.
- The [@nodenock](https://medium.com/nodenock) Medium account. Ask Gregor or @RichardLitt.
- A premium Zoom account. (This allows us to have longer video calls. Otherwise, we can use Google Hangouts or some free service for multi-person calls.) @RichardLitt has a Zoom account we can use for now.
- The Gitter channel. We use this during the event to have synchronous chat as needed; really, though, Zoom seems to work.
- The [@nodenock](https://twitter.com/nodenock/) Twitter account. Ask [@gr2m](https://github.com/gr2m) or [@RichardLitt](https://github.com/RichardLitt).
- A Zoom account. (This allows us to have longer video calls. Otherwise, we can use Google Hangouts or some free service for multi-person calls.) [@RichardLitt](http://github.com/RichardLitt) has a Zoom account we can use for now.

## To Do

### Two Weeks Prior

- [ ] Create an issue suggesting a time for other maintainers. We tend to use an existing issue for this, but a new one would be fine.
- [ ] Pick a time. 12-16:00 EST seems to work best for us, given our distribution.
- [ ] **Choose something to hack on.** Otherwise, you're just going to have to pick stuff, and you lose focus during the event.
- [ ] **Choose something to hack on.** Otherwise we are just going to have to pick stuff, and you lose focus during the event.
- [ ] Comment in https://github.com/nock/nock/issues/1268 with a comment saying there will be call:
- [ ] Set up a standing Zoom video call for that time, and post a public link to it in this comment.
- [ ] Mention what needs to be hacked on in this comment.
- [ ] Write up a blog post, as needed, which you can then publicize elsewhere. This hasn't been necessary for all of them, but it does help. Anything long form about why the hacking should get done would be ideal.
- [ ] Invite your friends at least a week before hand.
- [ ] Schedule some tweets using Buffer. Have these go out every day up until the call.
- [ ] Schedule a short call or email with other maintainers the night before to make sure that everything is ready.

### The week of

- [ ] Invite your friends
- [ ] Post a public invitation on twitter

### The Day Of

- [ ] Post in all channels that the event is happening in 30 minutes, on the day of the event.
- [ ] Turn on Gitter, again. We don't keep Gitter on permanently as it is a forum we can't moderate.
- [ ] Show up to the event.
- [ ] HACK.
- [ ] Post a reminder on twitter 30 minutes before the event
- [ ] Show up to the event. Welcome everyone who joines throughout the event
- [ ] Do some fun work :)
- [ ] Try and close all work out - merge PRs during event, instead of later.
- [ ] Before it ends, write up a summary. Then: Tell people the event is over, so no one is confused. Post on Gitter and Twitter and in the GitHub issue.
- [ ] Celebrate.
- [ ] Before it ends, write up a summary. Then: Tell people the event is over, so no one is confused.
- [ ] Celebrate 🎉
- [ ] Update the comment on https://github.com/nock/nock/issues/1268 with a summary of what has been worked on

This list is meant to be a work in progress. We'll edit it and improve it as we go.

0 comments on commit de8a739

Please sign in to comment.