Merge pull request #3637 from libgit2/cmn/conventions CONVENTIONS: update to include general public API principles