net docs: Barebones doc renderer and net_docs target.

net/README.md

+TODO: Add network stack documentation. :)

[Randy Smith (Not in Mondays), 2015/01/23 15:04:18]

Cute, but I wince at it too; it feels like we shouldn't commit a file that's
purely a Todo.  Can you write up a bit about what the network stack is, what the
important subdirectories are, and what the plan for documentation is, to go in
here?  

[Deprecated (see juliatuttle), 2015/01/23 20:13:00]

That's a good bit of work itself; I'd rather either put in a placeholder here or
just not have the file at all.

[Randy Smith (Not in Mondays), 2015/01/26 17:29:34]

So I have a rule of thumb not to put in supporting infrastructure until it's
needed, meaning I generally commit infrastructure with the first use of it in
the system.  Now, like "tests in the same CL as code", that's mostly to make
sure that I don't go infrastructure-happy without there being a clear and
present need, and we clearly want to move in the MD direction.  So I'm ok with
just a placeholder.  No file at all wouldn't be ok, though (as you'd be
effectively committing things without a test case).  (I could see an argument
that you should have *some* markdown in this file, just to make sure that it's
actually being processed properly.  But I'm ok without.)

In other words: Ok :-}.

[Deprecated (see juliatuttle), 2015/01/26 20:49:21]

Acknowledged.