Transcript 1st European Web Platform Doc Sprint, February 8/9 2013, Berlin

1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
We salute YOU!
Roll WPD Video Here
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
1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
We are all yours.
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
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Agenda at a glance
1. Wassup?
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Agenda at a glance
1. Wassup?
2. Get s#¡t done.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
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
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
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
As you like it: Twitter, IRC
#WPDS
wpd.mx/chat
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
WebPlatform.org
Doc Sprint: Work Plan
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
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
APIs
Your main contact for the API focus group:
Scott Rowe.
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 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
CSS properties
Your main contact for the CSS focus group:
Chris Mills.
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Or... “do what you want!”
Don’t want to do API/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 Sprint, February 8/9 2013, Berlin, Germany
1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
Thanks!
Questions?
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
1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
WebPlatform.org
Beginners: Getting Started
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
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 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
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 Sprint, February 8/9 2013, Berlin, Germany
1st European Web Platform Doc Sprint
February 8/9 2013, Berlin, Germany
Thanks!
Questions?
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
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.
Review
What did we accomplish today?
How did it go?
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
Day TWO
Tomorrow:
9:00 Breakfast + Intro
10:00 Doc Sprint
13:00 Lunch
18:00 Review & Raffle
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
See you over at „Wind + Wetter“
1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany