1. 1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
2. 1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
We salute YOU!
3. 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 Sprint, February 8/9 2013, Berlin, Germany
4. 1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
We are all yours.
5. We are all yours
Chris Mills @chrisdavidmills
Julee Burdekin @adobejulee
Scott Rowe @scottrowex
Janet Swisher @jmswisher
David Kirstein #fr0zenice >IRC
Andre Jay Meissner @klick_ass
Simon Madine @thingsinjars
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
6. Agenda at a glance
1. Wassup?
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
7. Agenda at a glance
1. Wassup?
2. Get s#¡t done.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
8. Agenda at a glance
1. Wassup?
2. Get s#¡t done.
3. Go out & PARTY!
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
9. Infrastructure
This event is highly dependent
on 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
10. Infrastructure
Use copper over wireless.
Disable any personal hotspots/MiFis.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
11. 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
12. As you like it: Twitter, IRC
#WPDS
wpd.mx/chat
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
13. 1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
WebPlatform.org
Doc Sprint: Work Plan
14. 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
15. APIs
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 pages
wpd.mx/APIgd
• Choose what you want to work on
• Let us know, and get going!
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
16. APIs
Your main contact for the API focus group:
Scott Rowe.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
17. 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 pages
wpd.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
18. CSS properties
Your main contact for the CSS focus group:
Chris Mills.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
19. 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
20. 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
21. 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 Sprint, February 8/9 2013, Berlin, Germany
22. 1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
Thanks!
Questions?
23. 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 Sprint, February 8/9 2013, Berlin, Germany
24. 1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
WebPlatform.org
Beginners: Getting Started
25. Signing up
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
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
26. 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
27. Getting started
• Log in
• Note the root of the Wiki is at
http://docs.webplatform.org/wiki/
• Review the site structure at
Meta:Editors_Guide/Topic_Hierarchy
wpd.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
28. 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
29. 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
30. 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
31. 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 Sprint, February 8/9 2013, Berlin, Germany
32. 1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
Thanks!
Questions?
33. 1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
34. 1st European Web Platform Doc Sprint
February 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.)
35. 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
36. Thanks for joining us!
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany