[prev in list] [next in list] [prev in thread] [next in thread] 

List:       fedora-docs-list
Subject:    Re: [Help files] - Should help be local or internet based?
From:       Shaun McCance <shaunm () gnome ! org>
Date:       2011-03-03 13:19:54
Message-ID: 1299158394.26431.266.camel () recto
[Download RAW message or body]

On Thu, 2011-03-03 at 07:41 -0500, John J. McDonough wrote:
> On Thu, 2011-03-03 at 16:18 +1300, Jose Mathew Manimala wrote:
> > Hello docs team,
> >                              Need some help/advice. I am working with
> > FES[1] on getting a desktop entry file that points firefox to the domain
> > http://help.fedoraproject.org/ and acts as the first point of contact
> > for the user to search for help channels used by fedora. Would it be
> > better to have an offline version of the website as the first stage(an
> > html doc) and then for more goto http://help.fedoraproject.org/. Is this
> > redundant or would just a desktop entry file to
> > http://help.fedoraproject.org/ suffice?
> 
> The "redundant" website does give you a slightly more controlled way to
> handle languages.  Remember, the .desktop file allows you to
> internationalize the text on the menu itself, but always points to the
> same application.  So when you are pointing to a "document", the link
> needs to somehow direct the browser to the correct language, as well.
> 
> In Release Notes, for example, we have a small redirect page whose only
> purpose in life is to select the language.  Take a peek at
> 
> /usr/share/doc/HTML/fedora-release-notes/index.html
> 
> (with a text editor, not a browser).
> 
> Also, don't forget there are around a dozen browsers in the repo and
> they don't all behave exactly like firefox. Usually there aren't huge
> issues but it does make testing a little annoying.

I know we've talked about this before, but remind me why you
don't just install the DocBook to a standard location and let
Yelp worry about the language selection. Does it not handle
some DocBook features you use?

Thanks,
Shaun


-- 
docs mailing list
docs@lists.fedoraproject.org
To unsubscribe: 
https://admin.fedoraproject.org/mailman/listinfo/docs
[prev in list] [next in list] [prev in thread] [next in thread]