Ideal GNOME Developer documentation

If we had Ideal GNOME developer documentation, what would it contain? Or, what's really missing now? The Foundation Board would like do what we can to help to make wonderful documentation available, so we need an overview of what's needed. Please do add your ideas there, not worrying too much for now about how we would actually achieve it.