Open Web Docsですぞ

2021/01/28に公開

GoogleやMicrosoftなどIT大手連合が「Open Web Docs」を発表

GoogleやMicrosoftらで構成される大手IT企業連合が2021年1月26日に、Web開発者向のオープンなドキュメンテーションを支援するプロジェクト「Open Web Docs」の設立を発表しました。Mozillaも参加するこのプロジェクトは、Mozillaの不振により下火となっていたMDN Web Docsの空白を埋めるものになると期待されています。

とのこと。
Open Web Docs - Open Collective
https://opencollective.com/open-web-docs/updates/introducing-open-web-docs

Browser makers launch new project for writing documentation for Web APIs | ZDNet
https://www.zdnet.com/article/browser-makers-launch-new-project-for-writing-documentation-for-web-apis/

これだけではよく分からなかったが
Google、マイクロソフトらが設立、「Open Web Docs」を発表。MDNなど支援、Web技術のドキュメント化を推進
https://www.publickey1.jp/blog/21/googleopen_web_docsmdnweb.html
によると

Open Web Docsはおもに既存のコミュニティによるドキュメント、特にMozillaのMDNをまずは優先的に支援するとしています。

具体的にはOpen Web Docsが何らかのドキュメントプラットフォームを立ち上げるのではなく、さまざまなコミュニティの取り組みなどを支援していくとしています。なかでも今年はまず、MozillaのMDNの支援を優先事項として取り組むと「Introducing Open Web Docs」で次のように示しています。

つまり以下を支援するということだ。
https://developer.mozilla.org/ja/

ドキュメント好きの者としては以下も今日はつまみ食い。
質の高い技術文書を書く方法
https://blog.riywo.com/2021/01/how-to-write-high-quality-technical-doc/
「文書から得られるアウトプットが明確で、読み手のレベルによらず一定に伝わること」

結論を冒頭で書き、おなじ内容をまとめでも書く。これを意識するだけでとても伝わる。
この文書自体がとてもお手本になる。

Discussion