>
> It raises the question: is content being driven by the toolchain (Gnome
> 3 Yelp uses Mallard, whereas Maverick Ubuntu Help Center uses docbook)?
>

I agree with Matthew here. We chose this toolchain (Mallard + Yelp) because
it provided a better user experience (at least in the on-disk context) than
DocBook, and it is easier to write and extend than DocBook.

Besides, the people who were working on Gnome docs are pretty much the same
people who are working on Ubuntu docs. Phil Bull, myself, Tiffany
Antopolski, Natalia Ruz . . . we all helped shape Gnome 3 help and we all
use Ubuntu. (Or at least we use Ubuntu as our primary desktops...).

I'm entirely open to using different tools in the sense that I would be
willing to write for content that goes on the desktop or web, but I'm not a
web developer, and don't have the time and inclination to develop a doc CMS
and get it integrated into the Canonical infrastructure. If Canonical has a
need for a more web-based help system, I think it would be a good area for
them to invest more resources.


> (Ubuntu Docs in Maverick was well translated into many languages, and
> translation of Gnome 3 topics + new Ubuntu Topics is at best uncertain.)
>
> Another approach would be to ask: What do Ubuntu Natty users need for
> content (on-disk/online)? Then let content development flow from that (with
> due consideration of delivery formats and localization).
>

I agree that the even the help we are working on now may need to be
re-architected a bit. The online portion remains a bit of an open question.
Again, I'm open to other (online) approaches.


> A related question is: how important is it that content be independent
> from the display application (yelp)?
>
>
Ryan Lortie and Shaun McCance talked about some additional ideas at the doc
hackfest in Toronto, even talking about getting some help-specific features
into GTK itself. Shaun would be the person to talk to about that stuff.

Thanks for the questions, Kyle.

-- 
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/753072

Title:
  yelp docs not about ubuntu natty

-- 
ubuntu-bugs mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to