-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Cody A.W. Somerville wrote: > ReST actually looks really confusing. Doesn't it use grave accents for some > things?
Yes, but why is that phrased as a question? We use backticks (grave accents) in almost all of our docstrings. It's important that our developers be able to distinguish between apostrophes and backticks. Similarly, since our docstrings our ReST, a developer who cannot write ReST cannot properly document their code. > 2. Hyperlinks: Wow. Talk about confusing. There are direct, indirect, > internal, embedded, anonymous, and implicit hyperlinks. They all involve > an underscore (or two) and probably some grave accents. fwiw, I also find Moin hyperlinking confusing: - JustCamelCase - !HowDoISuppressThisAgain? - [[Not Camel Case Wiki Link]] - http://example.com - [[http://example.net|Text for link]] I usually find it easier to copy from another page than to remember all that. Aaron -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iEYEARECAAYFAkqyPUgACgkQ0F+nu1YWqI0SaACfY5YPalqBil3g1eMmcxf/LIIa guMAn22HAjmooy7/CsmQXIOZlRu/0do/ =bjGR -----END PGP SIGNATURE----- _______________________________________________ Mailing list: https://launchpad.net/~launchpad-dev Post to : launchpad-dev@lists.launchpad.net Unsubscribe : https://launchpad.net/~launchpad-dev More help : https://help.launchpad.net/ListHelp
