Notes based on files

[dignifiedquire]

It would be great if I could include longer form documents in the toc. Something like this

toc: 
  - name: Introduction
    file: intro.md
  - name: About
    description: "Cool stuf is happening in here"

and then the content is simply read in from the intro.md file instead inlined in here.

[dignifiedquire]

If this sounds good, I'm happy to work on this, but I'm not entirely sure where the best place is to add the processing of file -> fs -> description would be.

[tmcw]

Cool! The code path for loading a configuration is lib/commands/shared_options -> load_config.js but the best place to load descriptions from files would be in sort.js, since that code is called regardless of if you use the CLI or the Node API. The linked section is where I think you'd be at the best place to implement - where we test for val.description we could also test for val.file and load & parse the file if it exists.

[dignifiedquire]

@tmcw PR is up :)