What I dont understand is why the BMax docs couldn't have been like the docs you got with B3D and BPlus.
One major difference is the modular design of blitzMax -- while B3D and B+ have a static command set that will be identical for everyone, BlitzMax has a potentially huge variety of modules installed, each of which have their own documentation that needs to be integrated.
A little trickier to do than the old way, where all help data was kept in a single place, and updated by a single person/company.
Each new moduilke you install can add bits and pieces to the help under blitzMax. Convenient, but it does mean an internally radically different help system is required to cope with that.