On Tue, Dec 9, 2014 at 12:27 PM, Jeff King <peff@xxxxxxxx> 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 majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html