Merge branch 'jk/uploadpack-packobjectshook-fix' into maint
[gitweb.git] / Documentation / CodingGuidelines
index 48aa4edfbdd180e1c6d874b6bb61ea5fc8e32ef5..8dddb50a9df7100577aab159a3fc1f7db09953c3 100644 (file)
@@ -358,7 +358,10 @@ For C programs:
    string_list for sorted string lists, a hash map (mapping struct
    objects) named "struct decorate", amongst other things.
 
- - When you come up with an API, document it.
+ - When you come up with an API, document its functions and structures
+   in the header file that exposes the API to its callers. Use what is
+   in "strbuf.h" as a model for the appropriate tone and level of
+   detail.
 
  - The first #include in C files, except in platform specific compat/
    implementations, must be either "git-compat-util.h", "cache.h" or