Join GitHub today
GitHub is home to over 36 million developers working together to host and review code, manage projects, and build software together.Sign up
We should finish (and start distributing) the DoES Liverpool New Member Manual #118
The idea was to develop something like https://wiki.nottinghack.org.uk/images/9/96/Nottingham-hackspace-manual-web-Nov2011.pdf
Andy Goodwin did an initial draft, which I still haven't looked through, but we should at least be tracking progress on it in here :-)
referenced this issue
Jan 30, 2017
Copying my comment over from #434...
The handbook is, as you rightly surmise, the "introduction to DoES" guide. There will be a massive overlap with the wiki, and it'd be good to get to a point where it pulls in chunks of the wiki (so we only have to write things once) and similarly directs people to the wiki. I think it'd also have some more background info on DoES as a community, and have the subset of info that's most important to a newcomer. (And likely be created as a PDF we can email to them, or maybe we'd even get some copies printed up - there's been talk of it becoming something akin to the Hiut Denim yearbook, with interesting articles interspersed with the need-to-know info.
@amcewen Yes, it's possible - the ESLint project would be a good example and code reference. There are markdown linters which can help validate content prior to exporting, and then converters to turn it in to HTML, PDF, etc. If you need more infos let me know.
I've just been reading through the handbook and many sections are incomplete or out of date. I'll make some quick changes to fix broken links (eg. to the old wiki) but I'm not sure I can currently help much with the rest of it as I'm still a DoES newbie.
Suggestion: Wait until the updated "DoES vision" (marketing, etc) is taking shape before doing any more work on handbook (as the handbook should be align with 'marketing' of DoES and vice versa).
I think @aubergine10's suggestion of waiting until the vision, etc. has been done is a good one. This will be moving up my priority list once the vision stuff is finished.
And the main reason for this comment is to add a link to the Institute of Making's 4th yearly report as another example of something to crib ideas from.
I particularly like the "members' profiles" section, but some of the "talks given" and "projects undertaken" are nice ideas too (maybe "projects undertaken" could be more "notable collaborations", to highlight how people end up building things together - Tosca, Fomocam...)