[CRISP-TEAM] Alan Barrett's comments on the BW7 draft.

[Bill Woodcock]

> On Jan 15, 2015, at 3:55 AM, Alan Barrett <apb at cequrux.com> wrote:
> 1. I think that the cover letteer should be in a separate document.

I disagree.  I believe that our eventual primary work product should be a single PDF file containing everything in one.  If we split things into separate files, they will inevitably become disassociated in the future.  I don’t think it matters much in the one-week timeframe, but I think this is very important in the two year + timeframe.

> 2. In the table of contents, only the top level headings have page
> numbers.  I suggest also adding page numbers for second-level headings
> but not for third-level headings.

I started that way, of course, and found it was too cluttered to be legible, but that’s a matter of personal taste, and as in all things, I’ll defer to the consensus…  I also tried making everything below L1 enumerated but much smaller, or in gray, and neither of those seemed to be improvements.

                                -Bill




-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 841 bytes
Desc: Message signed with OpenPGP using GPGMail
URL: <https://www.nro.net/pipermail/crisp/attachments/20150115/57a1e312/signature.asc>