Export to

• Google Calendar
• iCalendar file
• hCalendar markup
  <div class="vevent h-event"> <h1 class="summary p-name">Write The Docs PDX: Enabling Walkup Contributions to Your Project Documentation</h1> <div class='date'><time class="dtstart dt-start" title="2015-02-03T18:00:00" datetime="2015-02-03T18:00:00">Tuesday, February 3, 2015 from 6</time>–<time class="dtend dt-end" title="2015-02-03T20:00:00" datetime="2015-02-03T20:00:00">8pm</time></div> <div class="location vcard p-location h-card"> <a class="url" href='http://calagator.org/venues/202394689'><span class='fn org p-name'>eBay Community Lounge</span></a> <div class="adr p-adr h-adr"> <div class="street-address p-street-address">1400 SW 5th Avenue, 3rd Floor</div> <span class="locality p-locality">Portland</span> , <span class="region p-region">OR</span> <span class="postal-code p-postal-code">97201</span> <div class="country-name p-country-name">US</div> (<a href='https://maps.google.com/maps?q=1400%20SW%205th%20Avenue,%203rd%20Floor,%20Portland%20OR%2097201%20US'>map</a>) </div> </div> <div class="description p-description"> <p>Everett Toews, Developer Advocate at Rackspace Hosting, will share his experience using Git and Markdown to make it easier for the community to propose changes to their documentation. Please arrive by 6pm. I want to start sort of promptly, by 6:05. (I'll be there by 5:30.) The building entry doors will be locked at 7pm. I'll appreciate help cleaning up, so we can depart by 8:30.</p> <hr> <p>A common complaint against many open source projects is documentation. Insufficient, incorrect, non-existent, hard to find, and difficult to update are things we typically all hear. There are a lot of different ways to tackle these problems. There's no silver bullet but one of my favorite tactics is lowering the barriers for absolutely anyone to contribute documentation.</p> <p>Ideally, lowering the barriers means:</p> <ul> <li><p>using a common and well understood documentation markup language</p></li> <li><p>using documentation editors that are commonly available</p></li> <li><p>not requiring your contributors to install and configure tools</p></li> <li><p>providing a preview of the updates to make reviews reviews easier</p></li> </ul> <p>Learn how Apache jclouds has enabled walkup contributions to our project documentation. We've benefited from better documentation, shorter review times, and building community through contribution.</p> </div> <h3>Links</h3> <ul> <li><a class="url u-url" href="http://www.meetup.com/Write-The-Docs-PDX/events/219798767/">Website</a></li> </ul> </div>