Can docbook and mallard co-exit? Yes - a proof of concept

[Kyle Nitzsche]

Phil Bull wrote:
> Hi Kyle,
>
> On Sat, 2010-01-23 at 10:30 -0500, Kyle Nitzsche wrote:
>   
>> Following my previous prototyping/implementation testing:
>>  (http://lists.ubuntu.com/archives/ubuntu-doc/2010-January/014293.html)
>>
>> I was wondering whether we could open the door to some mallard without 
>> moving to all mallard.
>>     
> [...]
>   
>>  * With the exception of the ghelp url issue I could not resolve, it is 
>> perfectly doable to have a docbook page have a link to mallard
>>  * this opens a path to experimentation and incremental implementation
>>     
>
> I like this idea. Perhaps we can resolve to write new (desktop) docs in
> Mallard and link them in as you propose. 
I suggested that mallard (brilliant, incomplete) enables anyone who can 
package to add content to Ubuntu Help Center. And I observed that users 
have no way of knowing whether content was official or was added by such 
means. And that some such mallard content could be wrong in various and 
unknown ways. Therefore,  mallard is not (yet) appropriate for Ubuntu 
system docs until this (at least) is resolved.

I also suggested that in the meanwhile, perhaps a mallard section could 
be created (with a link on the Ubuntu Help Center home page) to enable 
user submissions (clearly labeled as such). Mallard's "simple" syntax 
seems especially applicable here.

So I don't think it's appropriate to write system help in mallard yet.

As an aside, I'm tracking my ubuntu-docs bits here: 
http://people.canonical.com/~knitzsche/

Cheers,
kyle


> The New to Ubuntu section would
> be a good candidate, perhaps? With that, we have the old material to
> fall back on.
>
> Thanks,
>
> Phil
>
>