I’m playing around with Slate (based on Middleman) with the goal to create an API documentation. Slate is just using one source/index.md file where you’re supposed to put all your content.
However, I would really like to generate this file out of individual section files, as one giant, single file would be hard to maintain. That’s the structure I’m looking for:
source/sections/accounts.md
source/sections/clients.md
source/sections/users.md
These files should be combined and rendered to one single source/index.html file. Any suggestions?