Write the Docs San Francisco Meetup May 2017

From mediawiki.org

Write the Docs San Francisco Meetup was hosted on May 4th between 7 - 9 pm at the Wikimedia Foundation in 5th-floor lounge. The goal of this meetup is to introduce tech writer volunteers to MediaWiki and share with them opportunities to contribute.

More details are here: https://www.meetup.com/Write-the-Docs-SF/events/239305204/

Meetup Agenda[edit]

  • 7:00 - 7:30 pm - Networking over pizza, snacks & drinks
  • 7:30 - 8:00 pm - Presentation from Juan Lara on his experience as a volunteer contributor to the MediaWiki documentation.
  • 8:00 - 8:20 pm - Wikimedia staff members will briefly present on specific projects looking for documentation help.
  • 8:20 pm - 9:00 pm - Small-group working session

Small-group working session[edit]

Attendees will get an opportunity to make their first contribution and have fun collaborating with fellow tech writers.

  • If you don't already have an account on MediaWiki, create one here
  • Pair up with somebody, pick a task from below, add your name next to it & start working!
No Task title Additional details Point of Contact Status
1. Improve the documentation of a MediaWiki extension: ArticlePlaceholder

#small #technical

Extension:ArticlePlaceholder requires a better understandable text and the dependencies should be up to date Lucie
3. Suggest or test alternatives to Doxygen

#small #technical

If you're familiar with alternatives to Doxygen or other tools indicated in the task, help us suggest the pros and cons of it srishakatux
4. Bring OOUI screenshots up-to-date

#small #technical

OOUI documentation was established with Apex theme screenshots, while MediaWiki theme is now default Volker E.
5. Add documentation to most used undocumented pages on Commons

#medium #technical

Look for recommended steps indicated in the Phabricator task Jarekt
6. Update manual for Huggle to contain stuff for Huggle 3

#medium #technical

See manuals linked in the Phabricator task that needs an update
7. Document how to create a new notification type

#medium #technical

Check for instructions in the comment here and in the duplicate task to learn how to proceed on this task Mooeypooo
8. Create documentation for addwiki library features

#medium #technical

Check for instructions in the Phabricator task Addshore
9. Verify Extension:Newsletter homepage for administrators contains up-to date information

#medium #technical

This task requires a clean MediaWiki 1.27+ & newsletter extension installation. Instructions to install the extension are indicated in the Extension:Newsletter homapage. After this step, verify information listed about the extension 01tonythomas
10. Update the template's configuration documentation

#medium #technical

Check for instructions in the Phabricator task Mobrovac
11. Create a "my first Python webservice" tutorial for Tool Labs

#big #technical

Write a detailed guide for setting up a new Python web service for Tool Labs. A portion of this task is ready here and contains next steps for which help is needed to move forward Bryan Davis
12. Create a "my first Pywikibot bot" tutorial for Tool Labs

#big #technical

Write a detailed guide for setting up a new Pywikibot tool for Tool Labs Bryan Davis
13. Create a "my first PHP webservice" tutorial for Tool Labs

#big #technical

Write a detailed guide for setting up a new PHP service tool for Tool Labs Bryan Davis
14. Document how to install Python modules in a tool's homedirectory / virtual environment

#big #technical

Check for instructions here on the bottom of the ticket Bryan Davis
15. Re-organize Tool Labs documentation

#big #technical

This task is about re-writing and better organizing the Tool Labs documentation Bryan Davis
16. Help identify documentation shortcomings and outline or create solution

#big #technical

Help streamlining OOUI documentation Volker E.

Photos[edit]