I have been using Drupal for a few months now at work. I love the developer documentation, but I have to say, I feel like its incomplete -- either that, or I just don't know where to find the other half.
I see documentation for functions and hooks everywhere, but I don't see any documentation for the format of core data structures.
Example one: this page from the official docs has extensive explanation on
hook_wysiwyg_editor_settings_alter, but it gives no complete disclosure what the
$settings parameter can contain.
Example two: this page from the official docs has great explanation of the concept of "Render Arrays" and the functionality thereof, but has no description of the format of the associative array passed to the
render() function, causing me to
var_dump($user_page) for hours and come up with monstrosities like:
<?php echo $user_page["system_main"]["nodes"][$first_key]["field_objective"]["#object"]->field_targets["und"]["safe_value"]; ?> on my custom .tpl.php files.
Is this information in the code itself, or somewhere else?