Well, the complete documentation also has to be added to the Codex, otherwise it isn't really useful. Finding how the stuff works while browsing through random code isn't very user-friendly. Ain't nobody got time for that.