Docs: describe project priorities

Relates to a recent discussion about which language features to use, but on a more general scale.

Also tries to make the docs better to come closer to fulfilling those principles.