Ben Coman <[email protected]> writes:

> This might be a case where is reasonable for both to be valid:
>   @ for backward compatibility
>    # for compatibility with internet conventions

- Pillar is not an Internet-related tool. It produces HTML, but not only:
  Pillar produces LaTeX and Markdown and we plan to make it support
  Docbook. For example, LaTeX uses \ref to represent anchors, should
  Pillar use \ref instead of @?

- Creating anchors in the document is done through the @@ syntax. As a
  result, both links and anchors use the same character. Switching to #
  for links only would break this similarity. Switching to # for both
  links and anchors would break even more document and website (but I
  think that's ok).

Breaking backward compatibility is ok, but we should pay attention when
we do it.

-- 
Damien Cassou
http://damiencassou.seasidehosting.st

"Success is the ability to go from one failure to another without
losing enthusiasm." --Winston Churchill

Reply via email to