typesetting of header / yaml

[kasperdanielhansen]

On both Safari and Chrome on OS X I see the top of the following vignette rendered with weird indentation: http://bioconductor.org/packages/devel/bioc/vignettes/BiocStyle/inst/doc/AuthoringRmdVignettes.html

I see

• author names and affiliation are indented
• date (add automatically, see below) indented
• the work abstract note indented, newline and then no indentation of the abstract text.
• similar with Package

I think all bold headers should have the same indentation level, and personally I think they should be non-indented.

I think it is weird that there is a newline after package. I would prefer no newline after the yaml stuff.

I think the auto-adding of the compilation time date is "bad" as we have seen from experience. I propose that at a minimum it gets prefaced with "Compilation date:" and I also think we should have the capability (and demonstrated in the package vignette) to have an "Last edited date:". Experience have shown this to be very useful.