Re: [webkit-dev] WebKit Documentation

2022-09-19 Thread Ling Ho via webkit-dev
On 9/19/22 4:48 PM, Fujii Hironori via webkit-dev wrote: Why not double-down on WebKit Git repository? The closer the document is to the source code, the easier to keep them up-to-date. We can modify both the source code and the document in a single commit through our review process. Do you

Re: [webkit-dev] WebKit Documentation

2022-09-19 Thread Fujii Hironori via webkit-dev
Why not double-down on WebKit Git repository? The closer the document is to the source code, the easier to keep them up-to-date. We can modify both the source code and the document in a single commit through our review process. Do you plan to shutdown https://trac.webkit.org/wiki ? ___

Re: [webkit-dev] WebKit Documentation

2022-09-19 Thread Michael Catanzaro via webkit-dev
Why not double-down on the GitHub wiki? It's very easy to learn to use, and there are edit buttons everywhere so there is no "distance" between the docs and the ability to edit them. The easier it is to edit docs, the better we'll do at keeping them up to date. I like Markdown, and am OK wi

[webkit-dev] WebKit Documentation

2022-09-19 Thread Brandon Stewart via webkit-dev
Hi WebKit Developers, Documentation is an important part of any open source project, especially for a larger project like WebKit. Being able to ramp up during the onboarding process, reading up on architectural decisions, and learning how to perform common procedures are all features the docume