Suggestion for new Yelp front page

[Andreas Lloyd]

Hey all - particularly Don and others interested in the Yelp front page
layout!

Don Scorgie wrote:
> Hi,
>
> On Fri, 2006-08-25 at 10:39 +0200, Andreas Lloyd wrote:
>> I've tried. It's not pretty:
>> http://eskar.dk/andreas/tmp/yelp%2520contents.html
>>
>> I hope it makes sense. I distinguish between the Frontpage which is what
>> we want to customize, and the Table o Contents which is autogenerated by
>> Yelp, and which we will link through. I hope that it is possible to link
>> to specific sections inside a document from the frontpage. That is why
>> we want to do a customized front page in the first place.
> I think I have a rough idea from the link. It'd be a fairly sizable
> patch to yelp (if I'm reading it right). Plus the sections linked adds
> an interesting twist to it... Unfortunately (for me), you've managed to
> put the idea in my head now.
:-)

> I have an idea of how it might work, but will need some time to come up
> with a prototype. Alas, I'm fairly busy right now with GNOME stuff,
> other projects and real world stuff.
Don, that sounds great! I really hope that something like this might end
up being possible. It would potentially make the Yelp frontpage much
more accessible for common questions. Please let me (and the rest of the
Ubuntu Doc team list) know if you make progress on this, and if there is
anything you need help with, like testing and such.

For now, though, we have Doc String Freeze for Edgy in a week's time and
need to come up with a usable solution in the short term. Our attempt at
combining the GNOME docs and our docs ran afoul due to unconsidered
licensing issues, and we'll need to make another patch to the Yelp Front
page to keep these separate and in the proper order.

Matthew East is going on holidays the coming week and gave me permission
to fix up the front page. I'll try to organize the .omf files as best as
I can, but I will need your help with ordering and placement in relation
to the GNOME docs. What I would like is something like this:

"""""""""""""""""""""""

About Ubuntu

Desktop Guide

Server Guide

Getting More Help

Contributing to Ubuntu

Packaging Guide

---

General Documentation

Desktop
- Learn the basics of the GNOME desktop environment

Applications
- Manuals for installed programs

Command Line Help
- Advanced system documentation

Other Documentation
- Miscellaneous technical documents


"""""""""""""""""""""""

I hope this is a structure that makes sense to everyone. It is fairly
close to the current one, mostly because I wasn't sure if we were
keeping the "Other Document Categories" or not - obviously, we want the
GNOME docs in there somewhere, but I don't know the best approach to
this. Do we remove the other documentation completely and just add the
"Basics of the GNOME desktop" to the top section? If we can do that,
that would be nice.

Also, I've left out the "Switching to Windows" guide as it does not seem
to be close to completion, and left in the Packaging Guide, as it is
still as central document.

I've edited the relevant .OMF files for all of the Ubuntu docs - mostly
wording changes and such, so these are open for discussion, too. In
general, I've tried to do the best I could without changing the whole
structure of the table of contents.

Don: I hope it is possible to change the general order of the Yelp front
page to fit these changes. Any and all questions are welcome.

Team: I've attached the changes to the .OMF files. Please check them and
see if they are acceptable to you. If they are, maybe some can commit
them as well. :-)

Cheers,

Andreas

-- 
https://launchpad.net/people/lloydinho
-------------- next part --------------
A non-text attachment was scrubbed...
Name: OMF-file.changes.diff
Type: text/x-patch
Size: 6256 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20060907/e2c05d4b/attachment.bin>