cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dblotsky <>
Subject [GitHub] cordova-docs pull request: ToC Generation Refactor
Date Wed, 20 Apr 2016 02:16:24 GMT
GitHub user dblotsky opened a pull request:

    ToC Generation Refactor

    **Note**: this PR is easier to review one commit at a time, and the commit messages roughly
describe each change.
    - now `*-src.yml` files are mandatory for each docs version
    - `*-src.yml` files get turned into `*-gen.yml` files
    - renamed `*-manual.yml` files to the new `*-src.yml` format
    - ToCs now contain only entries with `uri`s (unless they have children)
    - pages now specify their ToC name using the `title` or `toc_title` front matter property
    - removed the `name` property from ToC entries, moving it to the respective page where

You can merge this pull request into a Git repository by running:

    $ git pull toc-gen-refactor

Alternatively you can review and apply these changes as the patch at:

To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:

    This closes #583
commit 7022ab8713517e99904fbe0a33ac02aa0a637dc0
Author: Dmitry Blotsky <>
Date:   2016-04-20T01:45:44Z

    Refactoring ToC generation process: source ToCs are always required, and the result ToCs
are generated from them. Refactoring Makefile for better readability.

commit 297128f29dabf2afc7b9c620b048d589029f02f6
Author: Dmitry Blotsky <>
Date:   2016-04-20T01:53:43Z

    Renamed ToCs to match new ToC build process.

commit 7b879387a81617b8a783e58398f84aefb1b9a181
Author: Dmitry Blotsky <>
Date:   2016-04-20T02:05:57Z

    Moving ToC names into toc_title properties for their respective files, and also removing
the 'name' property from all ToC files.


If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at or file a JIRA ticket
with INFRA.

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message