I'm an engineer and have worked in IT for several decades. I know the real world and what I have written is normal, not utopian.
Unlike you we aren't getting paid for this however. We work on FPC in our free time.
Returning to the documentation, it disturbs me that it is spread in too many different places: language reference guide (which should be the only official source), forum, wikis written by users (sometimes inaccurate, duplicated and obsolete), new features wiki, developer mailing list, user mailing list, etc.
The Language Reference Guide already
is the only official source and we often repeat this. However documentation for new features is usually only done once a new release approaches until then the
New Features Trunk page or the announcement mails for the corresponding feature
are the official documentation.