The documentation is currently very thorough and useful, but the Future/yield section under concepts is still marked as TODO. This is one of the major confusing aspects of the framework for new devs and a lot of benefit would be garnered by completing this section.