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
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.