Web sites for docteam
Henrik Nilsen Omma
henrik at gotadsl.co.uk
Thu Jun 2 17:34:22 UTC 2005
Sean Wheller wrote:
>Not sure you will need to integrate it. What we will be developing is a full
>web-based application. With multiple books available. Trying to run it under
>another web-app will just complicate it and fear losing screen real-estate to
>functions that are not a part of the help system.
>
>
Not integrate it under another web-app, but simply integrate the layout
so that it fits in with the rest of the site. I presume the pages would
actually be in static HTML.
>The same application will be installed and deployed with the distro. Hmmm,
>actually perhaps this will make help.ubuntu.com rather redundant. The
>difference is that on help.ubuntu you will have all documents in all
>languages and google based search, whereas on the distro we will only install
>key docs and eachlang will be in a separate lang pack (well that's what I am
>asked to believe). Example of a doc that will not be packaged is the
>Installation Guide. No need once you have the product installed. Maybe it is
>just good to have them all there. Not sure.
>
>
There are lots of reasons why it's a good idea to have it on-line.
People might want to read a before installing, might have trouble
installing or might be giving advice to someone else over the phone
while not at their Ubuntu system, whatever. Also having the WIP docs on
line at docteam.u.c will allow devels and testers to see documentation
that might not be in the distro yet.
>
>
>Basically all we need is that there is a default
>http://help.ubuntu.com/index.html. The folders etc. we will build and link to
>from the index.html.
>
Right, so help.ubuntu.com/index.html would contain a 'Welcome to the
Documentation Center' page with links to the release-specific info and
some general info. help.ubuntu.com/breezy/index.html would in turn be
the base page for the breezy help.
I agree with your work process, though I think the layout needs to be
integrated better with the existing site than your image suggests. It
should probably go under the 'Support' tab. I'll do some more thinking
and make a mock-up web page.
- Henrik
More information about the ubuntu-doc
mailing list