webplatform.org doc sprint berlin feb 8-9 2013
TRANSCRIPT
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
1st European Web Platform Doc SprintFebruary 8/9 2013, Berlin, Germany
We salute YOU!
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Infrastructure
#1 Nov 3 2012: Adobe, San Francisco#2 Dec 12 2012: Google, Mountain View
#3 Feb 8/9 2013: Today. You. Us.
wpd.mx/events
1st European Web Platform Doc SprintFebruary 8/9 2013, Berlin, Germany
We are all yours.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Chris Mills @chrisdavidmillsJulee Burdekin @adobejulee
Scott Rowe @scottrowexJanet Swisher @jmswisher
David Kirstein #fr0zenice >IRCAndre Jay Meissner @klick_assSimon Madine @thingsinjars
We are all yours
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
1. Wassup?
Agenda at a glance
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
1. Wassup?
2. Get s#¡t done.
Agenda at a glance
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
1. Wassup?
2. Get s#¡t done.
3. Go out & PARTY!
Agenda at a glance
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Infrastructure
This event is highly dependenton a speedy uplink to the Intertubes!
We are linked up with two times 50 MBit/s Down & 5 MBit/s Up.
Pleeeeze use that bandwidth wisely.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Infrastructure
Use copper over wireless.
Disable any personal hotspots/MiFis.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Infrastructure
Make use of the good cell coverage.Turn off any sync services.
Turn off E-Mail.
Avoid any unnecessary traffic.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
#WPDSwpd.mx/chat
As you like it: Twitter, IRC
1st European Web Platform Doc SprintFebruary 8/9 2013, Berlin, Germany
WebPlatform.orgDoc Sprint: Work Plan
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Hello, and welcome!
The two focus groups we have today are:
• The API reference group
• The CSS property reference group
• (float from one to the other if wished)
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
There are a lot of APIs we want to cover on WebPlatform.org, with docs at different stages. To get started:
• Read the API project plan: wpd.mx/APIpr
• Read our Guide to creating API pageswpd.mx/APIgd
• Choose what you want to work on
• Let us know, and get going!
APIs
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Your main contact for the API focus group:Scott Rowe.
APIs
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
CSS properties
There are a load of CSS properties to cover, and we need your help! To get started:
• Read the CSS project plan: wpd.mx/CSSpr
• Read our Guide to CSS property pageswpd.mx/CSSgd
• Choose what you want to work on (concentrate on highest priorities first)
• Let us know, and get going!
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Your main contact for the CSS focus group:Chris Mills.
CSS properties
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Or... “do what you want!”
Don’t want to do CSS docs? How about
• Fixing bugs
• Working on templates/extensions
• Writing some different docs
• Working on skinning
• You could also do just demos, or writing, or proofing...
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Working practice
Work how you want, as long as you are happy and productive!
Collaborate. Help each other!
Let us know what you’re working on, and when you start new things.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Getting help
We are keeping it low-fi during the sprint!
• Grab a steward
• Raise your hand
• Talk to others next to you
• Don’t be afraid — we won’t bite (much)
1st European Web Platform Doc SprintFebruary 8/9 2013, Berlin, Germany
Thanks!Questions?
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
This is for the newcomers!
Those of you who are already experienced with using WebPlatform.org
can now get started.
1st European Web Platform Doc SprintFebruary 8/9 2013, Berlin, Germany
WebPlatform.orgBeginners: Getting Started
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
You’ll need a free WebPlatform.org account:
• Go to docs.webplatform.org
• Hover over Log in
• Click the Create account link
• Fill in and submit the form
Signing up
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Submitting bugs
We track site bugs at W3’s Bugzilla:
• Go to w3.org/bugs
• Click Open a new Bugzilla account
• Follow the instructions
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Getting started
• Log in
• Note the root of the Wiki is athttp://docs.webplatform.org/wiki/
• Review the site structure atMeta:Editors_Guide/Topic_Hierarchywpd.mx/SiteStr
• Read the editor’s guide at WPD:Editors_Guide -> wpd.mx/EdGd
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Things to bear in mind
• You need to be logged in before you can edit things
• When making major edits or adding a new page, work offline on a text editor
• If you want to move or delete pages, talk to us first
• It’s Media Wiki based!
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Media Wiki crash course
• (Almost) no tags needed
• * and # for bullets and numbers
• =x=, ==x==, etc. for heading levels
• ’’x’’ and ’’’x’’’ for bold/italic
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Media Wiki crash course
• [URL link-text] for external links
• [[relative-URL|link-text]] for internal
• [file:filename.xxx] for embedding files
• Tables are horrible
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Media Wiki crash course
• <syntaxHighlight></syntaxHighlight> for code blocks
• <code></code> for inline code
• Use <div> and <span> to hang style=”” off, for bespoke styling
• Use proper list markup for complicated lists
1st European Web Platform Doc SprintFebruary 8/9 2013, Berlin, Germany
Thanks!Questions?
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
1st European Web Platform Doc SprintFebruary 8/9 2013, Berlin, Germany
Go grab a DRINK!It‘s about time to review & wrap up for
today and we‘ll start with that soon.(And there will be prizes.)
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Review
What did we accomplish in this Doc Sprint?
How did it go?
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Thanks for joining us!