As part of preparing for stabling the "new-style" apache configuration, eclasses etc. we've written 3 documents describing upgrading to the new apache, troubleshooting common problems and how to update ebuilds etc. They are all written in guide-xml and currently live at /proj/en/apache. I expect to stable the new apache about 3-4 weeks after the documentation is moved to allow users to prepare themselves for the changed configuration.
All three documents are now available from the main documentation repo. http://www.gentoo.org/doc/en/apache-{troubleshooting,upgrading,developer}.xml Fixed coding style and some language constructs. Welcome on board, new documents! :)