class LegacyDocMigrator
extends Object

Migrates gdoc-based user guides from the old style, in which the section numbers are included in the filenames, and the new style which uses a YAML-based TOC file to organise the sections. It doesn't do a perfect job but it does a lot of the hard work and you can fine tune the generated gdocs afterwards.

The migration will not only rename and restructure the gdoc files, but it will also generate a toc.yml file that reproduces the existing guide structure. Additional files include:

• links.yml - a YAML file mapping new section names to the old ones. Ensures that URL fragments in old external links continue to work.
• rewriteRules.txt - a simple text file that maps the old chapter HTML filenames to their new ones. Useful for creating Apache URL rewrite rules.

The names of the new sections are based on the old section names, so they may not be ideal. Also, the new style requires that every section has a unique name, although the documentation publishing will pick up and warn of duplicates.