Het webplatform documenteren, door Florian Scholz Documenting the Web Platform, by Florian Scholz

Het collectief Open Web Docs wordt gesponsord door een community van mensen en bedrijven die documentatie voor het webplatform belangrijk vinden. In deze talk verkennen we hoe het web wordt gedocumenteerd bij MDN Web Docs en hoe we ons voorstellen dat documentatie een plek krijgt in de bredere context van de workflows van developers. Spreker: Florian Scholz, Content Lead bij Open Web Docs Twitter van Florian: https://twitter.com/floscholz Inhoud: 00:00 Introductie 00:51 Over Open Web Docs 01:49 De waarden van Open Web Docs 03:18 Wat doet Open Web Docs? 04:40 De verhuizing van MDN naar GitHub 07:32 HTML vs. Markdown 08:54 Wat documenteert MDN? 10:06 Wat is documentatie eigenlijk? 12:04 Referentiedocumentatie vs. specificatie 13:19 Een typische referentiepagina op MDN 15:16 Data over browsercompatibiliteit 16:25 IDE's en DevTools 17:22 Specificatiedata 18:38 Zo draag je bij Meer details: https://pages.jetbrains.com/javascript-day-2021 #JavaScript #JavaScriptDay2021 ––– 🔗 Bekijk onze bronnen 🔗 Probeer WebStorm, een JavaScript-IDE van JetBrains, 30 dagen gratis: https://www.jetbrains.com/webstorm/ ⭐️ Blijf in contact ⭐️ JetBrains op Twitter: https://twitter.com/JetBrains WebStorm op Twitter: https://twitter.com/WebStormIDE

The Open Web Docs collective is sponsored by a community of people and companies who care about docs for the Web platform. In this talk, we are going to explore how the Web gets documented at MDN Web Docs and how we'd imagine documentation to appear within a broader context of developers' workflows. Speaker: Florian Scholz, Content Lead at Open Web Docs Florian's Twitter: https://twitter.com/floscholz Content: 00:00 Introduction 00:51 About Open Web Docs 01:49 The values of Open Web Docs 03:18 What does Open Web Docs do? 04:40 MDN's move to GitHub 07:32 HTML vs. Markdown 08:54 What does MDN document? 10:06 What is actually documentation? 12:04 Reference documentation vs. specification 13:19 A typical MDN reference page 15:16 Browser compatibility data 16:25 IDEs and DevTools 17:22 Specification data 18:38 How to contribute More details: https://pages.jetbrains.com/javascript-day-2021 #JavaScript #JavaScriptDay2021 ––– 🔗 Browse our resources 🔗 Check out WebStorm, a JavaScript IDE by JetBrains, and get a 30-day free trial: https://www.jetbrains.com/webstorm/ ⭐️ Keep in touch ⭐️ JetBrains on Twitter: https://twitter.com/JetBrains WebStorm on Twitter: https://twitter.com/WebStormIDE