Documentation is futile, make machines do it
Workshop proposal for http://makercon.no
Fablabs, maker- and hackerspaces across the world all stuggle with a common problem: documentation. Projects made are consistently underdocumented, often missing one or more critical piece of information needed to understand, use and reproduce the project.
Current approaches to this problem are usually centered around setting up content management systems which make it 'easy' for users to upload & publish documentation, along with policies/guidelines for what to document and how. None seem to tackle the seemingly fundamental problem: that manually creating and uploading required documentation artifacts is a tedious, error-prone and not immediately rewarding process.
We propose to make the machines and software used to create the project do most of the work for us. That they should automatically gather and publish most parts of the required documentation, and to actively e