Install profiles docs seem outdated/incorrect

I'm going to post this here instead of at the group, but the following is a sample education install profile I've begun writing for School Engine which I'm going to port over to Drupal.

Since I found out hook_configure isn't in the installer it took a little different solution to add my own form to the post-install process. Just thought I'd include this as a mini-example and hope it helps clarify anything even though it's not really filled out. Webchick probably has a more filled out example?

// school_engine_basic.profile

/**
 * Implementation of hook_profile_modules().
 * 
 * Return an array of the modules to be enabled when this profile is installed.
 *
 * @return
 *  An array of modules to be enabled.
 */
function school_engine_basic_profile_modules() {
  // Core modules.
  $modules = array('block', 'color', 'comment', 'filter', 'help', 'menu', 'node', 'system', 'taxonomy', 'user', 'watchdog',
    'og', 'og_vocab', 'views', 'views_rss', // School Engine modules.
    'school_engine', // School Engine core modules.
    'devel', // Other modules.
  );

  return $modules;
}

/**
 * Implementation of hook_profile_details().
 * 
 * Return a description of the profile.
 */
function school_engine_basic_profile_details() {
  return array(
    'name' => 'School Engine - Basic',
    'description' => 'Select this profile to enable some basic School Engine functionality and the default theme.',
  );
}

/**
 * Implementation of hook_install().
 */
function school_engine_basic_install() {
  drupal_goto('school_engine_install_configure');
}

// school_engine.module
/**
 * Implementation of hook_menu().
 */
function school_engine_menu($may_cache) {
  $items = array();

  if ($may_cache) {
    $items[] = array('path' => 'school_engine_install_configure', 
      'title' => t('School Engine Configuration'),
      'callback' => 'drupal_get_form', 
      'callback arguments' => array('school_engine_install_form'),
      'access' => TRUE, 
      'type' => MENU_CALLBACK,
    );
  }
  return $items;
}

/**
 * FAPI callback; generate install form.
 */
function school_engine_install_form() {
  $form = array();
  
  $form['include_sample_data'] = array(
    '#type' => 'checkbox',
    '#title' => t('Include sample data'),
  );
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Submit'),
  );
  return $form;
}

/**
 * FAPI callback; validation for install form.
 */
function school_engine_install_form_validate($form_id, $form_values) {
  // Validate here.
}

/**
 * FAPI callback; submit for install form.
 */
function school_engine_install_form_submit($form_id, $form_values) {
  if ($form_values['include_sample_data']) {
    _school_engine_install_sample_data();
  }
}

/**
 * Helper function to install sample data.
 */
function _school_engine_install_sample_data() {
  // Create sample taxonomy vocabularies and terms.
  $form_values = array(
    'name' => t('Course categories'),
    'nodes' => array('page' => 'page'),
    'multiple' => TRUE,
  );
  drupal_execute('taxonomy_form_vocabulary', $form_values);

  // Create sample groups and test posts.
  $form_values = array(
    'title' => t('Test course'),
    'body' => t('Test course description'),
  );
  $node = new StdClass();
  $node->type = 'group';
  drupal_execute('node_form', $form_values, $node);
}

Webchick, I'm on the docs team but can't edit that installer page as it's unpublished. Can you publish it again or give me rights so I/we can help edit it?

Heh, I know a little bit. Next week, I'll update the docs to try and help get people up-to-speed writing basic install profiles.

I updated the docs. Probably needs a once over from somebody else. I left most of webchick's GJG stuff in there and just did a revamp of the top. Setting to fixed, mark as active if it needs more love.

Also, I think we should rename profile's hook_install() to hook_profile_install() for D6. Issue at http://drupal.org/node/101008.