Someone will probably point me to a readme/blogpost, but I don't really understand Stack Overflow documentation. Maybe it should be renamed Stack Overflow Examples?
Documentation usually has a table of contents. It's organized. Documentation usually has an introduction. Documentation usually progresses from simple topics to complex ones built on the foundations of the simple ones.
Stack Overflow documentation has examples first and foremost. I get you want examples, but where is a user unfamiliar with the topic supposed to start?
Maybe the problem is the topic I'm contributing to started with "Introduction to X". I have no idea who requested that or if it's the default, but an introduction to X (let's assume X windows) would not start with an example. It would describe what X is (it's a windowing system). It would probably also describe a few basic things about it (it's a client/server architecture unlike most local windowing systems). Until the user has some concept of those things the example isn't going to make much sense. But, there's no place to put that information. All you can do is add an example as the very first thing under the topic "Introduction to X".
I'm sure there's plenty of topics that need some kind of description before the example an plenty that need to start with baby steps and build up.
Am I missing it? Am I not supposed to explain those fundamental things? As it is, the hints seemed to suggest I was suppose those details in "remarks", but looking at the page created it seems unlikely any user is going to read the "remarks" section buried at the bottom of the page.
Am I just not understanding?