| 1 |
Xavier Neys wrote: |
| 2 |
|
| 3 |
> Besides, allowing conditional bodies would let us solve bugs like |
| 4 |
> http://bugs.gentoo.org/show_bug.cgi?id=52856 or the latest |
| 5 |
> http://bugs.gentoo.org/show_bug.cgi?id=132816. Paragraphs like "Sparc users or |
| 6 |
> PPC machines blah blah di blah" are getting more and more common and |
| 7 |
> inconsistencies such as the partitioning schemes in the the hb-ARCH-disk.xml |
| 8 |
> files and the common hb-install-config.xml are inevitable without conditionals. |
| 9 |
|
| 10 |
Well... I had this exact problem with the MIPS handbook. There was |
| 11 |
quite a bit of information, not relevant to other architectures, that I |
| 12 |
needed to get across, which related to stageball selection. |
| 13 |
|
| 14 |
Thus, MIPS is the only ARCH that has it's own stage selection section |
| 15 |
(hb-install-mips-stage.xml), whereas the others all share a common file |
| 16 |
(hb-install-stage.xml). |
| 17 |
|
| 18 |
This meant I could go into greater detail, and thus made (IMHO) a higher |
| 19 |
quality manual. |
| 20 |
|
| 21 |
> The good side is we could deliver less encumbered handbooks and please our users. |
| 22 |
> The drawback is that it makes writing text that flows properly in all cases |
| 23 |
> more difficult for us. |
| 24 |
|
| 25 |
Yeah, this is definitely an issue. It'd mean having to write the doc a |
| 26 |
few times to get it right with all possible selections. Then again, the |
| 27 |
solution I went with (to get around this issue) also involves a lot of |
| 28 |
duplication of information, which has its drawbacks too. |
| 29 |
|
| 30 |
-- |
| 31 |
Stuart Longland (aka Redhatter) .'''. |
| 32 |
Gentoo Linux/MIPS Cobalt and Docs Developer '.'` : |
| 33 |
. . . . . . . . . . . . . . . . . . . . . . .'.' |
| 34 |
http://dev.gentoo.org/~redhatter :.' |
| 35 |
|
| 36 |
International Asperger's Year (1906 ~ 2006) |
| 37 |
http://dev.gentoo.org/~redhatter/iay |
Archives