1 |
On Tue, 17 Jan 2006, Josh wrote: |
2 |
|
3 |
> PS: Though the very idea of an "in-print" Gentoo book is in many ways absurd, as |
4 |
> Gentoo is unique among Linux distros for its generally faster-paced, evolving |
5 |
> nature, these draft handbooks present the best possible approach to actually |
6 |
> publishing a "dead tree" Gentoo guide--something that would be a first for the |
7 |
> distro, AFAIK. Given Gentoo's rapidly changing nature (e.g. fundamental pieces |
8 |
> like Portage and baselayout), the need for a paper Gentoo book might seem |
9 |
> obviated. But I'm strangely attracted to the idea. It seems more doable now that |
10 |
> the draft handbooks have less of a specific Gentoo emphasis. I'd certainly be |
11 |
> interested in seeing Gentoo documentation in print! |
12 |
|
13 |
Over a year ago, I worked on writing some style sheets that could be used |
14 |
with xsltproc to convert the GuideXML documents to LyX format. Then I did |
15 |
various editing and formatting to work on a print format. (It is a lot of |
16 |
work to convert to a book format; the GuideXML is great for HTML and web |
17 |
though.) |
18 |
|
19 |
I also heard from someone who also was working on making the handbook into |
20 |
a print format. But now that over a year has passed, I guess not. |
21 |
|
22 |
One problem I had was that the content (at that time) was constantly |
23 |
changing. It was too time consuming for me to merge in my changes, |
24 |
regenerate the LyX from the GuideXML each time (especially since that |
25 |
would mean losing my later changes), or manually editing both my LyX files |
26 |
and my copies of the orginal GuideXML files. |
27 |
|
28 |
A couple things that would help me: |
29 |
|
30 |
- have a consistent release of the handbook to base it on (like 2005.1); |
31 |
and have a freeze period where I know the handbook would not be updated |
32 |
(except for critical fixes). Then plan for that, such as the print book |
33 |
will be available (already printed) for 2006.2 (second quarter) by April |
34 |
1. |
35 |
|
36 |
- access to real CVS, so I don't have to use web-based CVS or tarballs to |
37 |
merge changes. (Is there publically-available anonymous cvs yet?) |
38 |
|
39 |
It would be good to survey to see if there is a potential market. Do we |
40 |
know at least 100 people would purchase the book? 1000 people? Since |
41 |
Gentoo already has a defined community, this would be easy to find out. |
42 |
|
43 |
Another thing to consider is to make a list of concepts or objectives |
44 |
publically available from the LPI and the BSD Certification Group |
45 |
(ignoring the BSD specific) to see if any "important" areas are missing |
46 |
from the Gentoo (to-be) printed book. |
47 |
|
48 |
Jeremy C. Reed |
49 |
|
50 |
technical support & remote administration |
51 |
http://www.pugetsoundtechnology.com/ |
52 |
-- |
53 |
gentoo-doc@g.o mailing list |