Initial documentation

[keithm-xmos]

• General lib use and flash part requirements
• How to set 8mA drive strength for flash part
• How to use app specific flash with calibration words

[xmos-jmccarthy]

Documentation complete as of de865d7d730485d170f7c77f68a44eb5f752f469

Additional xmake support added.