OMG It's so good to hear that the codex will be getting an overhaul, it is absolutely awful for a beginner to navigate and find stuff. Why the codex doesnt just follow the same format/design as the WP codex I don't know. It needs clear explanations, easy searchability and organization, and good examples.