| 1 |
On Sat, Nov 27, 2010 at 10:50 PM, Mike Frysinger <vapier@g.o> wrote: |
| 2 |
> On Saturday, November 27, 2010 16:39:04 Alec Warner wrote: |
| 3 |
>> On Sat, Nov 27, 2010 at 6:53 AM, Zac Medico wrote: |
| 4 |
>> > As it is, I'm fairly comfortable with docbook. Now you want me to learn |
| 5 |
>> > a new format, with possible drawbacks, in order to try and draw in some |
| 6 |
>> > contributions that may never happen? |
| 7 |
>> |
| 8 |
>> Here is where I would look for data. Are there pending contributions? |
| 9 |
>> I have not seen anyone on this list specifically say "I'd write some |
| 10 |
>> documentation if it was not in docbook." I have had issues (years |
| 11 |
>> ago) getting vapier to write documentation; but I assumed that was |
| 12 |
>> because he hated writing docs and he contributed documentation after a |
| 13 |
>> while. |
| 14 |
> |
| 15 |
> not sure where you're going with this, but i'm the one who started the doc/ |
| 16 |
> dir and introduced the docbook system. obviously i have no problem with it |
| 17 |
> and would rather see real examples of people who are being impeded by it |
| 18 |
> rather than yet another "omg we need to switch to this awesome new format |
| 19 |
> because it is so awesome". |
| 20 |
> -mike |
| 21 |
> |
| 22 |
|
| 23 |
Hi Mike, |
| 24 |
|
| 25 |
at the beginning, I've just made a try and see if it would be |
| 26 |
feasible, then I decided to suggest the portage team about it, that's |
| 27 |
all. |
| 28 |
As I said before, if the majority of relevant people are not |
| 29 |
interested and want to stay with a docbook source, that's totally |
| 30 |
fine. I never meant to change habits neither do I pretend that |
| 31 |
asciidoc is awesome. It was simply a suggestion, in case you did not |
| 32 |
know it. |
| 33 |
|
| 34 |
I also understand that it's not good to change formats all the time.If |
| 35 |
docbook is well established as the reference tool for you to make |
| 36 |
docs, then please, keep the docbook format and just forget about the |
| 37 |
discussion. |
| 38 |
|
| 39 |
As an aside note, that would be a bit more pleasant to read if the |
| 40 |
current doc had a bit of css styling. Would you be against that ? I am |
| 41 |
not a designer at all, but I can still suggest a css for docbook, |
| 42 |
unless some Gentoo project already suggests one. |
| 43 |
|
| 44 |
Best regards, |
| 45 |
Lionel |
Archives