-
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #6 from nock/gr2m-patch-2
Update how-to-run-a-maintainathon.md
- Loading branch information
Showing
1 changed file
with
18 additions
and
25 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |