Re: [PATCH 3/3] api-credentials.txt: add "see also" section

On Tue, Jun 05, 2012 at 08:12:29AM -0700, Junio C Hamano wrote:

quoted

Here is a simple fix. The Makefile bits are more hacky than I would
like. It would be really nice if the asciidoc macro could convert "we
are working on X/Y/Z.html" into "we need ../../ to get to the relative
base", but I don't think it is that flexible.

We could also replace asciidoc with a wrapper script that does the
conversion and sets the appropriate attribute. I don't know if it is
worth the trouble. It's not like we add documentation subdirectories
very often.

Sorry, but I am not sure what problem is this trying to solve.  An
API documentation page should only refer to command documentaion
pages, and never another API documentation page that is at the same
level?

No, but it should not use linkgit to do so (and if we did ever grow
linkgit targets in a subdirectory, it should call them with the full
directory name from the documentation root, just as documents in the
root would do).

-Peff