webplatform.org doc sprint berlin feb 8-9 2013

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

Upload: andre-jay-meissner

Post on 27-May-2015

270 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 2: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

We salute YOU!

Page 3: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 4: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

We are all yours.

Page 5: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 6: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

1. Wassup?

Agenda at a glance

Page 7: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

1. Wassup?

2. Get s#¡t done.

Agenda at a glance

Page 8: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 9: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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.

Page 10: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Infrastructure

Use copper over wireless.

Disable any personal hotspots/MiFis.

Page 11: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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.

Page 12: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

#WPDSwpd.mx/chat

As you like it: Twitter, IRC

Page 13: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

WebPlatform.orgDoc Sprint: Work Plan

Page 14: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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)

Page 15: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 16: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Your main contact for the API focus group:Scott Rowe.

APIs

Page 17: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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!

Page 18: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Your main contact for the CSS focus group:Chris Mills.

CSS properties

Page 19: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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...

Page 20: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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.

Page 21: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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)

Page 22: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Thanks!Questions?

Page 23: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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.

Page 24: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

WebPlatform.orgBeginners: Getting Started

Page 25: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 26: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 27: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 28: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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!

Page 29: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 30: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 31: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 32: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Thanks!Questions?

Page 33: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Page 34: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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.)

Page 35: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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?

Page 36: WebPlatform.org Doc Sprint Berlin Feb 8-9 2013

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

Thanks for joining us!