Gabor Kovesdan wrote
in <51e2ea74.9070...@freebsd.org>:
ga> >> It breaks the list. It is even worse in PDF rendering since there are
ga> >> page boundaries and it breaks the page up to two parts.
ga> >
ga> > I see what you mean. But if we say "don't use admonitions in lists
ga> > because they
On Sun, 14 Jul 2013, Gabor Kovesdan wrote:
I find different fonts for filenames and commands to be useful, even in
titles. The O'Reilly style guide doesn't mention anything about title
styles, and in a quick search I did not find anything else.
Ok, it doesn't specify it explicitly but can you
On 2013.07.14. 18:02, Warren Block wrote:
On Sun, 14 Jul 2013, Gabor Kovesdan wrote:
Em 14-07-2013 14:52, Warren Block escreveu:
On Sun, 14 Jul 2013, Gábor Kövesdán wrote:
Some more things:
- Admonitions (top, note, warning boxes) look quite strange in
lists and such places. I think we sho
On Sun, 14 Jul 2013, Gabor Kovesdan wrote:
Em 14-07-2013 14:52, Warren Block escreveu:
On Sun, 14 Jul 2013, Gábor Kövesdán wrote:
Some more things:
- Admonitions (top, note, warning boxes) look quite strange in lists and
such places. I think we should add a policy to avoid them and start
c
Em 14-07-2013 14:52, Warren Block escreveu:
On Sun, 14 Jul 2013, Gábor Kövesdán wrote:
Some more things:
- Admonitions (top, note, warning boxes) look quite strange in lists
and such places. I think we should add a policy to avoid them and
start changing the markup.
Admonitions are overuse
On Sun, 14 Jul 2013, Gábor Kövesdán wrote:
Some more things:
- Admonitions (top, note, warning boxes) look quite strange in lists and such
places. I think we should add a policy to avoid them and start changing the
markup.
Admonitions are overused in some places. They are visually jarring,
>Number: 180551
>Category: docs
>Synopsis: [patch] document NULL encryption algorithm in geli(8)
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible:freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class:
Some more things:
- Admonitions (top, note, warning boxes) look quite strange in lists and
such places. I think we should add a policy to avoid them and start
changing the markup.
- We extensively use markup in titles, which later renders with a
different font. E.g. we mark the X of 9.X as r