This repository has been archived by the owner on Sep 24, 2022. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 5
Announcement 1
Cameron Shorter edited this page Nov 14, 2019
·
3 revisions
- 2019-11-11: Emailed to WriteTheDocs-Australia-2019 attendees.
Hello documentarians,
I’m hoping a bunch of you will feel inspired to join TheGoodDocsProject FixIt workshop, 13:00 Thursday 14 November 2019 at Write the Docs Conference, Sydney Australia.
We started TheGoodDocsProject to create best-practice templates and writing instructions for documenting open source software. With our alpha release, we’ve created some common templates which we’d love people to test, break and improve.
Topics:
Diverse contributions encourage. We hope to cover:
- As a user or developer or writer: Try writing instructions for your favourite application based on one of our templates. Give us feedback.
- As a technical writer or information architect: Review one of our templates, try and find limitations, suggest modifications, offer sections to add, debate improvements.
- You have another idea:_ Let’s hear it._
Schedule:
- 5 min: Introduction.
- 30 min: Break out into groups brainstorming topic.
- 15 min: groups present back to everyone.
- 30 min: Break out2.
- 15 min: Groups present2.
- 5 min: wrapup and thanks
Logistics:
- We will have flip charts and pens for brainstorming, and
- We will use track changes and Google Docs. (Bring a laptop.)
- Source templates: https://github.com/thegooddocsproject/templates
Post Fixit:
- Join our email list or slack chat.
- Help us triage ideas into our kanban board and issue tracker.
- Contribute further.
Who are we:
- Cameron Shorter, Business Analyst by day, Open Source Developer and accidental Technical Writer by night.
- Jared Morgan, Senior Technical Writer at Squiz
- Erin McKean, Docs Advocacy Program Manager at Google
- Felicity Brand (attending remotely), Technical Writer for Google Season of Docs
- Sanket Totewar, Technical Writer and a few more things
- Others from TheGoodDocsProject