Apparently the build system docs are now maintained in-tree, and they're 
translated/mirrored automatically to a website.  The system is build-specific 
right now, but work is happening to make it whole-tree:

https://bugzilla.mozilla.org/show_bug.cgi?id=939505

I think it's substantially more likely that in-tree documentation will be 
accurate, than that out-of-tree documentation will be accurate.  It's easy to 
ensure documentation stays up-to-date with code, when you can ask to see the 
docs changes at the same time as the code changes during review.  It's also the 
case that having in-tree documentation makes per-release documentation far 
simpler: just generate docs from that release's source code, when you release.

What opinions do people have on moving our documentation out of MDN, into the 
tree?

Jeff
_______________________________________________
dev-tech-js-engine-internals mailing list
[email protected]
https://lists.mozilla.org/listinfo/dev-tech-js-engine-internals

Reply via email to