Idea about the handbook

[Warren Block]

On Sun, 22 May 2016, Jason Gorman wrote:

> Hey, i've recently become interested in FreeBSD and of course stumbled
> across the handbook. Have to say it's brilliant!
>
> One thing however I found slightly annoying is that i've been reading the
> handbook in my spare time, and chances are whilst reading it i've been on
> either my tablet or my phone. Unfortunately the handbook doesn't seem to be
> very mobile or tablet friendly.
>
> My profession is currently a front end developer and I would love to tweak
> the CSS file for the handbook, and send it over to you guys to see what you
> think.

I think I speak for numerous people when saying we would be very 
interested in that.  The FDP Primer shows how to check out and build the 
docs:
https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/

There is a lot there to digest.  I (and others) can help you get a local 
build of the website working to experiment on.

As an aside, note that we have beta-quality epubs which might be more 
suited to mobile use.  They are on the FTP server now:
ftp://ftp.freebsd.org/pub/FreeBSD/doc/en_US.ISO8859-1/books/handbook/book.epub

The "beta" part is that image links are broken.  I investigated that, 
and it's something to do with the build environment--the links are fine 
when built normally on a developer system.  However, I ran out of time 
to work on it.  It only affects images, which are mostly in the 
installation chapters, so most of the book is usable.

> Having the handbook responsive would help a great deal, especially if for
> example i'm configuring a system and wanted to lookup the handbook on my
> phone for reference.
>
> Let me know if this is something you guys would be interested in.

Absolutely!