I can volunteer to do a 30-min open source documentation workshop directly after the morning assembly on both Saturday and Sunday.
The idea is to briefly introduce the why, how and for whom of open source documentation, introduce the techniques and templates that we decide on, provide people with tools, answer questions, allay fears, and basically remind and encourage people to document.
It is also a chance to introduce the people at the event who are knowledgeable about this topic and willing to help, so that people can ask questions at any stage later in the day.
Great! Are there any resources to share upfront? Maybe we could place this topic into the “Questions & Challenges” category if there were anything also to share online other locations could learn from. Or is it just you explaining the people documentation?
It will depend a little on who turns up - I’ll give a general introduction and use a few examples, and then, for example, walk any hardware projects through the process of using WikiFab,
Next week I will write a topic in the general ‘Questions & Challenges’ category with a basic introduction to different forms of documentation, their pros and cons, and some tips. This workshop will be a more detailed version of that post, customized to the needs of the attendants.
Thanks for taking part this morning, everybody! @huelfe@Jan_D@dax If you have any notes, thoughts or links to relevant resources that you would like to share, you can add them here or in the pad, and if you took manual notes, it would be great if you could upload a photo or scan! (button near top left)
@cameralibre, thanks for hosting! A few things I took away from this chat:
the ‘mug shot’ idea where everyone has a picture with their name and emai so contact data is not lost
image tags in instructions (#beginner, #intermediate, etc), so users can select a level of data that they want to interact with. After thinking about it, this could also be useful for filtering the preferred mode of information (something else we discussed this morning), e.g. images with summaries, only video, only text, etc.
taking five minutes before a standup to record what you would say is a free way to have daily changelogs of your team