...
Action Items: Read out to Write the Docs community for organization question
...
- Welcome, Ryan Steans!
- How can we use Ryan's time to get more resources for documentation?
- We have some infrastructure in place for tracking versioning, but it's not ideal. Could we improve the template to better handle versioning?
- Can we hire someone to write some documentation? What would that look like? (Discussion ensued.)
- Could they co-locate and organize existing documentation?
- Better structure or layout for documentation?
- Lots of enthusiasm for hiring someone who really knows jekyll
- Could we hire someone to organize a documentation sprint?
- Could we get some training for people about writing documentation?
- Can we host a "Write the Docs" event? How about a virtual event where we:
- Identify top priorities
- Identify who has the knowledge
- Pair (or triple) them up with someone who can interview them and take notes – or maybe it's a webinar?
- Process those notes after into digestable docs
- Proposal:
- Let's announce an event – what does it look like?
- Outcomes: Actual documentation
...
...
- restructure jekyll theme especially for left hand menu structure, addressing versioning across multiple gems, generalized organization of the site
- moving existing documentation spread across all the wikis to move the documentation to the centralized samvera.github.io site
- writing documentation (this requires some expertise that may present an obstacle)
...
- Option 1: Webinar style with a primary interviewer but that anyone in the community can attend and ask questions (would need to be shorter for Webinar part and use followup meetings for clarification and document writing)
- Option 2: Paired developer - documentor virtual sprint – (perhaps 1-3 days in length)
...
More possibilities at previous meeting brain storming.