Citizen onboard is a collaborative project to describe how our own government services work (and don't work). It's hosted publically on Github pages: http://lippytak.github.io/citizen-onboard/ and inspired by the endlessly awesome @UserOnboard.
This is a baby project so it needs your love to grow. There's a few ways you can bring help bring it to life:
- Next time you're dealing with your government, tweet about it with the tag #citizenonboard. Highlight the delights and the paint points. Hopefully we can build a little living library of our own experiences with government.
- If you have an idea for a new service to look at, open an issue and add what you know about it.
- If you're feeling a bit more ambitious, take a look at the existing issues and do some preliminary. Write about your own experience. Take some screenshots. Scan some forms. Include anything that helps describe your experience with the service and include it in a comment.
- If you still want more, then you're awesome. You should contribute your own CitizenOnboard slideshow. Take a look at the contribute section below to get started. If you do one, I'll send you a present. I'm not joking. Present TBD.
Questions? Get in touch @lippytak
- Install Node and NPM
- Install Cleaver:
npm install -g cleaver
(Cleaver generates nice little slideshows from markdown) - Fork this repo and create a new branch for your service
- Rename the
sample
directory andsample.md
file to the name of your service - Now for the fun part: Go take a bunch of screenshots/pictures/recordings/videos/flowcharts/whatever else you can imagine to document the process of using/enrolling in the service. Aim for exhaustion over perfection. Be creative and make it fun. Use whatever tools are at your disposal. So far I've had a good experience with:
- Awesome screenshot for full page screenshots,
- and Skitch for annotations.
- Edit the markdown (
.md
) slideshow. Just add an intro slide, lots of image slides, and a stats/author slide at the end. It should be pretty self-explanatory but feel free to reach out with questions. - Run
cleaver servicename.md
to generate the slideshow asindex.html
in the same directory. - Add a link to your new service in the root
index.md
and runcleaver index.md
to update the index page. - And you're done! Open
servicename/index.html
in any browser. Once everything looks right, send a pull request!