Docs in Flat Files

[lief-erickson]

One dictionary definition of flat file is a file that does not have internal hierarchy. I don't think that's the what is meant here. Is text-based file what's intended?

I would suggest that flat file be defined or that flat file be changed to text-based. Perhaps:

A flat file is any text-based file. It may be a plain text file, a Python or JavaScript file, or Markdown or even HTML or XML file, including a large number of other file types.

[briandominick]

Oh yeah I'll definitely define it. I'd never heard the non-hierarchical definition. Among developers flat file just means non-binary. Though Wikipedia defines a binary file such:

A binary file is a computer file that is not a text file. The term "binary file" is often used as a term meaning "non-text file".

That should clear it right up ;-)

[briandominick]

I think the term "text file" doesn't really do it, because so many people think in terms of text vs code, so text file sounds like it can't have code in it, or at least not functional code even if markup is accepted.