On 09/10/2012 11:56 PM, Jeff King wrote:
> On Mon, Sep 10, 2012 at 09:21:12PM +0200, Michael Haggerty wrote:
>> My plate is full. If you are able to work on this, it would be awesome.
>> As far as I'm concerned, you are the new literate documentation czar :-)
> Lucky me? :)
I was nominating Andreas, who rashly volunteered to help. But don't
feel left out; there's enough work to go around :-)
> I think I'll leave it for the moment, and next time I start to add some
> api-level documentation I'll take a look at doxygen-ating them and see
> how I like it. And I'd invite anyone else to do the same (in doxygen, or
> whatever system you like -- the best way to evaluate a tool like this is
> to see how your real work would look).
I agree with that. A very good start would be to mark up a single API
and build the docs (by hand if need be) using a proposed tool. This
will let people get a feel for (1) what the markup has to look like and
(2) what they get out of it.
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html