On Tue, Dec 9, 2014 at 12:27 PM, Jeff King <[email protected]> wrote: > > In which case can we simply start migrating api-strbuf.txt into > in-header comments, without worrying about a parsing tool? > > -Peff
That would be my preference as well. Putting the API documentation into the header files. Optionally if you're fancy you may enjoy the generated API documentation. But I personally would rather look into the header for the most up to date information. As said above the Documentation/technical would only serve a purpose to explain very high level concepts. So racy-git.txt or pack-heuristics.txt will fit in there very good. -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
