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!
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
 Simon Madine @thingsinjars

  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 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.
       (And there will be prizes.)
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!




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

WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

  • 1.
    1st European WebPlatform Doc Sprint, February 8/9 2013, Berlin, Germany
  • 2.
    1st European WebPlatform Doc Sprint February 8/9 2013, Berlin, Germany We salute YOU!
  • 3.
    Infrastructure #1 Nov3 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 WebPlatform Doc Sprint February 8/9 2013, Berlin, Germany We are all yours.
  • 5.
    We are allyours 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 aglance 1. Wassup? 1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
  • 7.
    Agenda at aglance 1. Wassup? 2. Get s#¡t done. 1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
  • 8.
    Agenda at aglance 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 ofthe 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 likeit: Twitter, IRC #WPDS wpd.mx/chat 1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
  • 13.
    1st European WebPlatform Doc Sprint February 8/9 2013, Berlin, Germany WebPlatform.org Doc Sprint: Work Plan
  • 14.
    Hello, and welcome! Thetwo 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 alot 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 contactfor the API focus group: Scott Rowe. 1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
  • 17.
    CSS properties There area 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 maincontact for the CSS focus group: Chris Mills. 1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
  • 19.
    Or... “do whatyou 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 howyou 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 arekeeping 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 WebPlatform Doc Sprint February 8/9 2013, Berlin, Germany Thanks! Questions?
  • 23.
    This is forthe 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 WebPlatform Doc Sprint February 8/9 2013, Berlin, Germany WebPlatform.org Beginners: Getting Started
  • 25.
    Signing up You’ll needa 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 tracksite 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 • Login • 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 bearin 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 crashcourse • (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 crashcourse • [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 crashcourse • <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 WebPlatform Doc Sprint February 8/9 2013, Berlin, Germany Thanks! Questions?
  • 33.
    1st European WebPlatform Doc Sprint, February 8/9 2013, Berlin, Germany
  • 34.
    1st European WebPlatform 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 weaccomplish in this Doc Sprint? How did it go? 1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany
  • 36.
    Thanks for joiningus! 1st European Web Platform Doc Sprint, February 8/9 2013, Berlin, Germany