Partial update for the developer documentation, expanding aread of
design decisions, workflow and testing.
Updated the BuildEnv documentation.
Removed documentation referring to old pyffi dependency which is now
included as a sub-module.
Removed reference to bpy api generation as it nolonger works and the
repo that was referred to has been deleted.