Improving docs for boto states

Ready to be merged!