The documentation would be combined into a single doc as if it had always existed in a single file.
Example
example-1.md:
---
name: Example
category: Examples
---
This is the first example.
```example-1.html
<em>Hello, world!</em>
```
example-2.md:
---
name: Example
category: Examples
---
This is the second example.
```example-2.html
<em>Hello, again!</em>
```
This should be handled equivalently to:
---
name: Example
category: Examples
---
This is the first example.
```example-1.html
<em>Hello, world!</em>
```
This is the second example.
```example-2.html
<em>Hello, again!</em>
```
Open questions
In what order should files be combined?
Alphabetically?
How should conflicting sets of front matter be handled?
Use only the first one?
Merge all, with the first (or last) values taking precedence if there are conflicts?
Prompted by https://github.com/nextbigsoundinc/stylemark/pull/13
The documentation would be combined into a single doc as if it had always existed in a single file.
Example
example-1.md
:example-2.md
:This should be handled equivalently to:
Open questions
In what order should files be combined?
How should conflicting sets of front matter be handled?