Hi, Stefan Beller wrote: > There are different opinions on how to document an API properly. > Discussion turns out nobody disagrees with documenting new APIs on the > function level in the header file and high level concepts in > Documentation/technical, so let's state that in the guidelines. I disagree with this. I think we should put all the API docs in the header file, like we're already doing in e.g. strbuf.h. Do you have a link to where in the discussion this split-docs strategy was decided? Thanks, Jonathan