SlideShare a Scribd company logo
1 of 10
How to read W3C specs
(the bare essentials)
Daniel Davis, W3C
@ourmaninjapan
Tip 1: Don't read the spec!
Well, not yet.
Look for demos first.
Tip 2: Understand these terms
● Informative (non-normative):
– e.g. examples, advice, reference
● Normative:
– rules to follow, formal
● Must → Should → May
● User Agent = Browser (most of the time)
Tip 3: Check the version
● “Stable” version
– www.w3.org/...
● “Dev” version
– dev.w3.org/...
Tip 4: Read the abstract & introduction
Tells you what the spec is for
Tip 6: Read the Table of Contents
And read it carefully – it's a good summary of the
content
Tip 7: Skip reference bits
● Status
● Conformance
● Terminology
● Privacy
● References
● Acknowledgements
● (until you're more confident)
Tip 8: Look for examples and IDLs
Because we love code!
Tip 9: And don't forget...
It's written for implementors, so read it from a
browser's point of view
How to read W3C specs
(the bare essentials)
Daniel Davis, W3C
@ourmaninjapan

More Related Content

Similar to How to read W3C specs

How to guarantee your change is integrated to Moodle core
How to guarantee your change is integrated to Moodle coreHow to guarantee your change is integrated to Moodle core
How to guarantee your change is integrated to Moodle core
Dan Poltawski
 
Auditing Drupal Sites
Auditing Drupal SitesAuditing Drupal Sites
Auditing Drupal Sites
Exove
 

Similar to How to read W3C specs (20)

How to guarantee your change is integrated to Moodle core
How to guarantee your change is integrated to Moodle coreHow to guarantee your change is integrated to Moodle core
How to guarantee your change is integrated to Moodle core
 
engage 2014 - JavaBlast
engage 2014 - JavaBlastengage 2014 - JavaBlast
engage 2014 - JavaBlast
 
Web design
Web designWeb design
Web design
 
Django Documentation
Django DocumentationDjango Documentation
Django Documentation
 
INTP-362 Course Introduction.pptx
INTP-362 Course Introduction.pptxINTP-362 Course Introduction.pptx
INTP-362 Course Introduction.pptx
 
Developers Best Practices
Developers Best PracticesDevelopers Best Practices
Developers Best Practices
 
Demise of test scripts rise of test ideas
Demise of test scripts rise of test ideasDemise of test scripts rise of test ideas
Demise of test scripts rise of test ideas
 
Fantastic Blogs and How to Write Them | Alaka Acharya.pptx
Fantastic Blogs and How to Write Them | Alaka Acharya.pptxFantastic Blogs and How to Write Them | Alaka Acharya.pptx
Fantastic Blogs and How to Write Them | Alaka Acharya.pptx
 
Basic software engineering principles - Session 1
Basic software engineering principles - Session 1Basic software engineering principles - Session 1
Basic software engineering principles - Session 1
 
How to become Softwar Enginneer
How to become Softwar EnginneerHow to become Softwar Enginneer
How to become Softwar Enginneer
 
Auditing Drupal Sites
Auditing Drupal SitesAuditing Drupal Sites
Auditing Drupal Sites
 
Web development | Derin Dolen
Web development | Derin Dolen Web development | Derin Dolen
Web development | Derin Dolen
 
prezentare workshop-taylor-and-francis-publishing-in-academic-journals–tips-...
 prezentare workshop-taylor-and-francis-publishing-in-academic-journals–tips-... prezentare workshop-taylor-and-francis-publishing-in-academic-journals–tips-...
prezentare workshop-taylor-and-francis-publishing-in-academic-journals–tips-...
 
Helping a journal apply to PMC when you’ve never done it before
Helping a journal apply to PMC when you’ve never done it beforeHelping a journal apply to PMC when you’ve never done it before
Helping a journal apply to PMC when you’ve never done it before
 
Hidden sides of Code Review (Do-iOS)
Hidden sides of Code Review (Do-iOS)Hidden sides of Code Review (Do-iOS)
Hidden sides of Code Review (Do-iOS)
 
NLJUG speaker academy 2023 - session 1
NLJUG speaker academy 2023 - session 1NLJUG speaker academy 2023 - session 1
NLJUG speaker academy 2023 - session 1
 
LCA13: Upstreaming 101
LCA13: Upstreaming 101LCA13: Upstreaming 101
LCA13: Upstreaming 101
 
Upstreaming 1013
Upstreaming 1013Upstreaming 1013
Upstreaming 1013
 
Dont run with scissors
Dont run with scissorsDont run with scissors
Dont run with scissors
 
Lecture 24
Lecture 24Lecture 24
Lecture 24
 

More from ourmaninjapan

HTML5: APIの活用事例 と 今後の広がり
HTML5: APIの活用事例 と 今後の広がりHTML5: APIの活用事例 と 今後の広がり
HTML5: APIの活用事例 と 今後の広がり
ourmaninjapan
 
HTML5とデバイスの連携: 良いところ、悪いところ、未来のこと
HTML5とデバイスの連携: 良いところ、悪いところ、未来のことHTML5とデバイスの連携: 良いところ、悪いところ、未来のこと
HTML5とデバイスの連携: 良いところ、悪いところ、未来のこと
ourmaninjapan
 
W3C Widgets、どこが面白い?
W3C Widgets、どこが面白い?W3C Widgets、どこが面白い?
W3C Widgets、どこが面白い?
ourmaninjapan
 
W3C Widgets: Why should I care?
W3C Widgets: Why should I care? W3C Widgets: Why should I care?
W3C Widgets: Why should I care?
ourmaninjapan
 
Widgets in theory and in practice
Widgets in theory and in practiceWidgets in theory and in practice
Widgets in theory and in practice
ourmaninjapan
 
Mobile web development without developing a mobile site
Mobile web development without developing a mobile siteMobile web development without developing a mobile site
Mobile web development without developing a mobile site
ourmaninjapan
 
実際のウェブページコーディング
実際のウェブページコーディング 実際のウェブページコーディング
実際のウェブページコーディング
ourmaninjapan
 
スマートTVへの アプローチと制作
スマートTVへの アプローチと制作スマートTVへの アプローチと制作
スマートTVへの アプローチと制作
ourmaninjapan
 

More from ourmaninjapan (20)

テレビのウェブ開発:その1
テレビのウェブ開発:その1テレビのウェブ開発:その1
テレビのウェブ開発:その1
 
テレビのウェブ開発:その2
テレビのウェブ開発:その2テレビのウェブ開発:その2
テレビのウェブ開発:その2
 
テレビのウェブ開発:その3
テレビのウェブ開発:その3テレビのウェブ開発:その3
テレビのウェブ開発:その3
 
Developing for TV
Developing for TVDeveloping for TV
Developing for TV
 
HTML5概要、コードサンプル
HTML5概要、コードサンプルHTML5概要、コードサンプル
HTML5概要、コードサンプル
 
The status of living HTML (highlights)
The status of living HTML (highlights)The status of living HTML (highlights)
The status of living HTML (highlights)
 
HTML5: APIの活用事例 と 今後の広がり
HTML5: APIの活用事例 と 今後の広がりHTML5: APIの活用事例 と 今後の広がり
HTML5: APIの活用事例 と 今後の広がり
 
HTML5とデバイスの連携: 良いところ、悪いところ、未来のこと
HTML5とデバイスの連携: 良いところ、悪いところ、未来のことHTML5とデバイスの連携: 良いところ、悪いところ、未来のこと
HTML5とデバイスの連携: 良いところ、悪いところ、未来のこと
 
Web payments
Web paymentsWeb payments
Web payments
 
testharness.js の基礎
testharness.js の基礎testharness.js の基礎
testharness.js の基礎
 
W3C Widgets、どこが面白い?
W3C Widgets、どこが面白い?W3C Widgets、どこが面白い?
W3C Widgets、どこが面白い?
 
W3C Widgets: Why should I care?
W3C Widgets: Why should I care? W3C Widgets: Why should I care?
W3C Widgets: Why should I care?
 
Widgets in theory and in practice
Widgets in theory and in practiceWidgets in theory and in practice
Widgets in theory and in practice
 
Mobile web development without developing a mobile site
Mobile web development without developing a mobile siteMobile web development without developing a mobile site
Mobile web development without developing a mobile site
 
実際のウェブページコーディング
実際のウェブページコーディング 実際のウェブページコーディング
実際のウェブページコーディング
 
HTML5: New capabilities, new markup
HTML5: New capabilities, new markupHTML5: New capabilities, new markup
HTML5: New capabilities, new markup
 
small 画面でも、 BIG 画面でも、 今すぐ使えるレスポンシブ活用術
small 画面でも、 BIG 画面でも、 今すぐ使えるレスポンシブ活用術small 画面でも、 BIG 画面でも、 今すぐ使えるレスポンシブ活用術
small 画面でも、 BIG 画面でも、 今すぐ使えるレスポンシブ活用術
 
スマートTVへの アプローチと制作
スマートTVへの アプローチと制作スマートTVへの アプローチと制作
スマートTVへの アプローチと制作
 
「Network Service Discovery API ができました!」 と言われた時
「Network Service Discovery API ができました!」 と言われた時「Network Service Discovery API ができました!」 と言われた時
「Network Service Discovery API ができました!」 と言われた時
 
Presentation Skills
Presentation SkillsPresentation Skills
Presentation Skills
 

Recently uploaded

Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Safe Software
 

Recently uploaded (20)

Emergent Methods: Multi-lingual narrative tracking in the news - real-time ex...
Emergent Methods: Multi-lingual narrative tracking in the news - real-time ex...Emergent Methods: Multi-lingual narrative tracking in the news - real-time ex...
Emergent Methods: Multi-lingual narrative tracking in the news - real-time ex...
 
MINDCTI Revenue Release Quarter One 2024
MINDCTI Revenue Release Quarter One 2024MINDCTI Revenue Release Quarter One 2024
MINDCTI Revenue Release Quarter One 2024
 
EMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWER
EMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWEREMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWER
EMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWER
 
"I see eyes in my soup": How Delivery Hero implemented the safety system for ...
"I see eyes in my soup": How Delivery Hero implemented the safety system for ..."I see eyes in my soup": How Delivery Hero implemented the safety system for ...
"I see eyes in my soup": How Delivery Hero implemented the safety system for ...
 
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
 
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data DiscoveryTrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
 
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
 
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
 
Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)
 
Apidays New York 2024 - Scaling API-first by Ian Reasor and Radu Cotescu, Adobe
Apidays New York 2024 - Scaling API-first by Ian Reasor and Radu Cotescu, AdobeApidays New York 2024 - Scaling API-first by Ian Reasor and Radu Cotescu, Adobe
Apidays New York 2024 - Scaling API-first by Ian Reasor and Radu Cotescu, Adobe
 
Artificial Intelligence Chap.5 : Uncertainty
Artificial Intelligence Chap.5 : UncertaintyArtificial Intelligence Chap.5 : Uncertainty
Artificial Intelligence Chap.5 : Uncertainty
 
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
 
MS Copilot expands with MS Graph connectors
MS Copilot expands with MS Graph connectorsMS Copilot expands with MS Graph connectors
MS Copilot expands with MS Graph connectors
 
Boost Fertility New Invention Ups Success Rates.pdf
Boost Fertility New Invention Ups Success Rates.pdfBoost Fertility New Invention Ups Success Rates.pdf
Boost Fertility New Invention Ups Success Rates.pdf
 
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
 
presentation ICT roal in 21st century education
presentation ICT roal in 21st century educationpresentation ICT roal in 21st century education
presentation ICT roal in 21st century education
 
Real Time Object Detection Using Open CV
Real Time Object Detection Using Open CVReal Time Object Detection Using Open CV
Real Time Object Detection Using Open CV
 
Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...
 
Automating Google Workspace (GWS) & more with Apps Script
Automating Google Workspace (GWS) & more with Apps ScriptAutomating Google Workspace (GWS) & more with Apps Script
Automating Google Workspace (GWS) & more with Apps Script
 
AWS Community Day CPH - Three problems of Terraform
AWS Community Day CPH - Three problems of TerraformAWS Community Day CPH - Three problems of Terraform
AWS Community Day CPH - Three problems of Terraform
 

How to read W3C specs

  • 1. How to read W3C specs (the bare essentials) Daniel Davis, W3C @ourmaninjapan
  • 2. Tip 1: Don't read the spec! Well, not yet. Look for demos first.
  • 3. Tip 2: Understand these terms ● Informative (non-normative): – e.g. examples, advice, reference ● Normative: – rules to follow, formal ● Must → Should → May ● User Agent = Browser (most of the time)
  • 4. Tip 3: Check the version ● “Stable” version – www.w3.org/... ● “Dev” version – dev.w3.org/...
  • 5. Tip 4: Read the abstract & introduction Tells you what the spec is for
  • 6. Tip 6: Read the Table of Contents And read it carefully – it's a good summary of the content
  • 7. Tip 7: Skip reference bits ● Status ● Conformance ● Terminology ● Privacy ● References ● Acknowledgements ● (until you're more confident)
  • 8. Tip 8: Look for examples and IDLs Because we love code!
  • 9. Tip 9: And don't forget... It's written for implementors, so read it from a browser's point of view
  • 10. How to read W3C specs (the bare essentials) Daniel Davis, W3C @ourmaninjapan