Thanks for that feedback, I will definitely take it all into consideration. At the moment our priority is making the getting started part of the documentation more complete, as well as producing actual datasheets for our products. Once this work is completed I will move on to strengthening our examples and library documentation. I agree with you its not clear what does what and how to use it if you arn't able to pick up the code and read through it all (you shouldn't have to). Once these have been improved the next step will be writing guides on best practices not just about memory usage but also power usage and security.
Once again thanks for the feedback, it has definitely been taken on-board and noted.