launchpad-dev team mailing list archive

[Aaron Bentley <aaron@xxxxxxxxxxxxx>]

-----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-----