If the doc can not be kept up-to-date, it is useless and should be reduced/removed or self-generated from the actual code - and I prefer it.

I personally use PHP source as doc directly.

• generate the doc for web-only, ie. remove it from repo
• do it for all repos