[Help files] - Should help be local or internet based?
shaunm at gnome.org
Thu Mar 3 13:19:54 UTC 2011
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 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
> (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?
More information about the docs