RFC: Changing the documentation's font style.

Gavin Atkinson gavin at FreeBSD.org
Fri Apr 12 11:43:05 UTC 2013


On Fri, 12 Apr 2013, Erich Dollansky wrote:
> On Fri, 12 Apr 2013 10:41:46 +0100
> Isabell Long <issyl0 at FreeBSD.org> wrote:
> 
> > I sent this idea to the #bsddocs IRC channel a few days ago and no-one
> > there objected, but here you go. I'd like to know your opinions on the
> > documentation font being changed from serif to sans-serif. This would
> > only affect the web-based docs, not the ones being prepared for print.
> > 
> > An example of this is at
> > http://tau.devrandom.co.uk/issyl0/en_US.ISO8859-1/books/handbook/ ,
> > and a diff of my very simple changes is at
> > http://tau.devrandom.co.uk/issyl0/docs_font.diff
> > 
> > In my opinion, it makes a hugely positive difference and modernises
> > the look of the documentation set.

Yes please!

> how old are you?
> 
> The serif fonts are easier to read for older people.

Online?  I personally disagree.

> I agree, it looks more modern. But what is the idea behind a
> documentation? Look good or being read by people for the content.

Both.  Content is essential, but I think we need to care far more about 
style than we currently do.  Even small changes like this can massively 
improve the feel of the website, and pull it, kicking-and-screaming, out 
of the mid-ninties.

Gavin


More information about the freebsd-doc mailing list