Lets Discuss Documentation
Saturday’s members meeting gave us the idea (thanks Mark) to host a document the space day (virtually) on Saturday 22nd August). This is your chance to help document various aspects of the space and to do this we need to start somewhere
So we all know the wiki is dead… its been dead for a long time, we discussed using moodle to document everything but having used it recently to I didn’t think it had the capabilities for what we wanted for storing useful information documents so instead we have https://docs.hacman.org.uk this is the hub for getting all the documentation together and its easy to do simply write what you want to document in markdown format (for anyone not familiar with markdown use stackedit.io as a wysiwyg editor that exports as markdown) and add the file to the documentation github repo at https://github.com/HACManchester/documentation/tree/master/docs or email (for now to board@ but this will change) and we will add it to the repo for you if your not a fan of github
I’ve added some generic documentation to it but there are areas of the space I can’t document as I have no clue about them! Note this shouldn’t take away from using the tools & equipment section of the members system for details on the tools but can be used for more detailed information, similarly it shouldn’t be used for training documentation that should be on moodle (but we will discuss moodle and training and inductions another night)
All old wiki content has been moved over to this too so that can be easily edited if its easier
(note the system is still in the setup stages I’ve not yet implemented the ci/cd deployment so that it will automatically update but i will deploy regularly until this is setup)
Feel free to bikeshed the system to your hearts content or be productive, help us document the space and lets get some of the knowledge that lives in our heads into some documents.