I completely agree, Hive account@klye. The lack of documentation has been very inconvenient.

From steem's readme:

Code is Documentation

Rather than attempt to describe the rules of the blockchain, it is up to each individual to inspect the code to understand the consensus rules.

It's really supposed to go the other way around: The consensus rules are documented, and the code is supposed to reflect them. How can there be alternative implementations if the protocol is defined solely in terms of the reference implementation?

This is something Steem will eventually need to get past, and it will likely not be a fun process.