The old horrible doctest-based buildout documentation has finally been replaced:

  http://docs.buildout.org

Jim

--