Hi Wstimson,
Thank you for your feedback. Jeff Wilson has touched on this topic on several occasions on the forums and answerhub. You can find one of his responses at the link below:
Updating documentation is definitely on our radar, please keep a lookout in the future for updates.