W3C specifications can be long and difficult to read, especially for non-native English speakers. This tells you the absolute basics for reading these specs. Originally written for Test The Web Forward events.
Transforming Data Streams with Kafka Connect: An Introduction to Single Messa...
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