[webkit-dev] WebKit Documentation

[Ryosuke Niwa]

> On Sep 19, 2022, at 4:48 PM, Fujii Hironori via webkit-dev <webkit-dev at lists.webkit.org> 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.

The fact documentation is separated from code is a feature, not a bug. We don't want to make updating documentation a contribution requirement. Just like unit tests, this sort of thing can significantly hinder our willingness and capabilities to do large scale refactoring, renames, etc...

- R. Niwa