[ghc-steering-committee] Section numbering

Joachim Breitner mail at joachim-breitner.de
Tue Feb 27 14:17:52 UTC 2018


Hi,

I did this, and updated all accepted proposals. The trick to not number
the title is to move the document title to the very top,
before all the “.. foo::” cruft, it is excluded from numbering. See
https://github.com/ghc-proposals/ghc-proposals/blob/master/proposals/00
05-bidir-constr-sigs.rst
for an example.

Cheers,
Joachim

Am Dienstag, den 27.02.2018, 09:13 +0000 schrieb Simon Peyton Jones:
> Joachim
> I think it’d be super-helpful to number the sections of a GHC proposal.  So much easier to navigate; and to refer to points in the discussion.
> It’s easy: just add
> .. sectnum::
> to the preamble.
> Could you do that to the template?  
> But one other thing.   If you look at
> https://github.com/Gertjan423/ghc-proposals/blob/quantified-constraints/proposals/0000-quantified-constraints.rst
> where I did that, you’ll see that everything is under Section 1.   better to give guidance about how to make a top-level heading that is just a heading, so only the other items have numbers.  Otherwise every section numbers starts “1.” which is silly.
> Thanks
> Simon
> _______________________________________________
> ghc-steering-committee mailing list
> ghc-steering-committee at haskell.org
> https://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-steering-committee
-- 
Joachim Breitner
  mail at joachim-breitner.de
  http://www.joachim-breitner.de/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: This is a digitally signed message part
URL: <http://mail.haskell.org/pipermail/ghc-steering-committee/attachments/20180227/ff812cb3/attachment.sig>


More information about the ghc-steering-committee mailing list