After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 335968 - Fold gnome-desktop/desktop-docs/gnome-feedback into the User Guide
Fold gnome-desktop/desktop-docs/gnome-feedback into the User Guide
Status: RESOLVED OBSOLETE
Product: gnome-user-docs
Classification: Core
Component: general
3.4.x
Other All
: Normal enhancement
: ---
Assigned To: Maintainers of Gnome user documentation
Maintainers of Gnome user documentation
Depends on: 452323
Blocks:
 
 
Reported: 2006-03-25 15:52 UTC by Joachim Noreiko
Modified: 2013-02-23 11:23 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Joachim Noreiko 2006-03-25 15:52:02 UTC
The files in CVS under desktop-docs/gnome-feedback could be folded into the GNOME Desktop User Guide, and expanded into a more general section on contributing to GNOME and joining the project.

If someone can take care of the technical side of things I'm happy to do the writing.
Comment 1 Vincent Untz 2006-03-25 15:54:07 UTC
What's involved on the technical side? :-)
Comment 2 Joachim Noreiko 2006-03-25 16:00:14 UTC
Um... I was hoping you'd know! :)
I imagine... 
* making sure anything that links to this documentation goes to the new location
* weird arcane CVS stuff
* getting the translations moved too
* other stuff I don't know about

Also, would we want to do this for 2.14.1, or wait till we're working on 2.15? I'm trying to avoid having two branches of the User Guide as long as possible.
Comment 3 Vincent Untz 2006-03-25 16:19:31 UTC
(In reply to comment #2)
> Um... I was hoping you'd know! :)
> I imagine... 
> * making sure anything that links to this documentation goes to the new
> location

Errr... The only things that link to this documentation is yelp (maybe) and other docs, I believe.

> * weird arcane CVS stuff

I can do this.

> * getting the translations moved too

Since the number of translations is low, it shouldn't be too hard.

> * other stuff I don't know about
> 
> Also, would we want to do this for 2.14.1, or wait till we're working on 2.15?
> I'm trying to avoid having two branches of the User Guide as long as possible.

I'd say it can wait for 2.15. But I'm not the one working on docs :-)

And what about moving the GPL/LGPL/FDL too?
Comment 4 Brent Smith (smitten) 2006-03-25 17:55:35 UTC
let's hold off on this until after the 2.14.1 release, since I'm going to basically apply everything that joachim is doing on HEAD to the gnome-2-14 branch before the 2.14.1 release.

I really shouldn't have branched...
Comment 5 Joachim Noreiko 2006-03-25 23:52:07 UTC
(In reply to comment #3)
> And what about moving the GPL/LGPL/FDL too?
>

I think Shaun said something about those going into doc-utils. Not sure on the details though, best check with him. 

Comment 6 Joachim Noreiko 2006-03-26 00:09:47 UTC
I'm happy to work on this for 2.14.1 -- my only concern was the various freezes in place that might prevent it.

Also, I wondered if the bug report tool links here?
Comment 7 Shaun McCance 2006-03-26 00:45:28 UTC
This is a 2.15/2.16 thing.  It's far too big of a change to put onto a stable branch.
Comment 8 Joachim Noreiko 2006-06-28 17:16:15 UTC
Can we work on it now, and how do we go about it?
Comment 9 Vincent Untz 2006-06-30 20:59:50 UTC
(In reply to comment #8)
> Can we work on it now, and how do we go about it?

Yes. I don't know :-) Shaun should know, I guess. Shaun?
Comment 10 Shaun McCance 2006-06-30 21:46:42 UTC
I don't think we should even try moving stuff around
in CVS.  We should just add new pertinent information
to the UG, and then kill gnome-feedback.

There is no plan to move stand-alone license files to
gnome-doc-utils.  We could move these as-is over to
gnome-user-docs though.  I think that makes sense.
Comment 11 Joachim Noreiko 2006-07-01 15:58:34 UTC
Ok.
I've copied over all the material from gnome-desktop/desktop-docs/gnome-feedback/ to the user guide, expanding the appendix I put in for 2.14. It's now in a new file, gosfeedback.xml.
I don't know what we're doing about the translations, so I've put comments to translators in the DocBook explaining that they can copy over existing translations from the old module.

The new DocBook ids are:
feedback-bugs -- Reporting bugs
feedback-wishlist -- Suggestions and comments
feedback-docs -- Documentation Comments

Over to someone else to do the necessary linking and whatever :)
Comment 12 Joachim Noreiko 2006-07-28 09:02:52 UTC
To put it more clearly, these are the changes to ids that need to be made throughout GNOME:

ghelp:gnome-feedback -> ghelp:user-guide?feedback
ghelp:gnome-feedback?index -> ghelp:user-guide?feedback
ghelp:gnome-feedback?feedback-main -> ghelp:user-guide?feedback
ghelp:gnome-feedback?bugreports -> ghelp:user-guide?feedback-bugs
ghelp:gnome-feedback?wishlist -> ghelp:user-guide?feedback-wishlist
ghelp:gnome-feedback?docs -> ghelp:user-guide?feedback-docs
Comment 13 Joachim Noreiko 2006-08-02 08:05:14 UTC
Status update:

I've notified the i18n and we're waiting now for translations to be moved.

I spoke to Shaun in IRC and he mentioned the possibility of setting up a redirect in yelp -- basically, a hack, as it's unlikely we'll change all ids in time for 2.16 (and manuals for applications outside of GNOME may be linking to it too).
Comment 14 Joachim Noreiko 2006-08-19 10:41:35 UTC
Shaun, you said something on IRC about putting a redirect in Yelp?
Comment 15 Vincent Untz 2006-11-13 20:15:20 UTC
Now sounds like a good time to fix this for 2.18 :-)
Comment 16 Joachim Noreiko 2006-11-13 22:10:12 UTC
I've done my bit.
I've also been updating the links in user manuals that I come across.

Shaun -- did you do the redirect?
Has the translation team moved the translations?

Someone needs to commit the patch for Bug 353087.
Comment 17 Vincent Untz 2007-06-29 17:50:41 UTC
Don tells me this depends on bug 452323.
Comment 18 Don Scorgie 2007-06-29 18:07:17 UTC
Brief overview of why this depends on bug 452323:

In current yelps (<2.20), yelp uses gnome_program_locate to find the relevant ghelp: file.  This basically takes the name and looks in <prefix>/share/gnome/help/ for it and returns the language-specific filename.

In the new pager system, we depend on Rarian which works differently.  It uses the meta-data filename to determine the ghelp name (i.e. feedback.document becomes ghelp:feedback) and the filename is extracted from there.  This means in order to do the redirect, you only need to change the <filename> element in the omf (or whatever the correct element is).

This is where it gets clever ;)  Rarian, during scrollkeeper-update will take the feedback.omf and turn it into feedback.document and ensure it's picked up correctly by yelp.

Of course, this depends on us getting our act together and getting the new pager system in place soon (to be in time for 2.20).  Otherwise, we will need to hack in a special "if requestedname == feedback: redirect to wherever" part.  But we will get the new pager system into 2.20, even if it involves us locking shaunm in a dungeon with only the source until it's done.
Comment 19 Christopher Yeleighton 2007-12-08 14:37:00 UTC
The master page <http://www.gnome.org/learn/admin-guide/2.14/> still says <ghelp:gnome-feedback>.  It causes yelp to display a blank page with a message box "Incorrect URL parameter".

dpkg -s 'gnome-user-guide'
[[
Package: gnome-user-guide
Version: 2.20.0+svn20071003ubuntu2
]]
Comment 20 Claude Paroz 2008-04-05 21:28:22 UTC
So what? This seems still problematic. 
BTW, what are the correct replacements for ghelp:[gpl|fdl] links?
Should we set a gnome goal to replace the obsolete links everywhere?
Comment 21 Christopher Yeleighton 2008-04-07 06:34:25 UTC
So the broken link on the master page should be fixed.
I do not know about 'everywhere'.  
As soon as this link is fixed and I find another one, 
I shall report that one as well.
Comment 22 Claude Paroz 2008-04-07 09:27:52 UTC
OK, I've just corrected the links (rev 836) to GNOME Feedback Page in the "About this document" section of the 3 guides.
Comment 23 Claude Paroz 2008-04-07 11:43:34 UTC
Oups... I still need to test the links in sysadmin-guide and accessibility-guide (as soon as I get home).
Comment 24 Claude Paroz 2008-04-07 21:26:36 UTC
Links corrected in guides.

The problem with ghelp:gpl (and co) not showing is a Ubuntu-specific bug, as we discussed it with Matthew and Vincent on #docs.

Now we should still correct ghelp:gnome-feedback links in all other docs... unless Don is able to do a redirection before that!
Comment 25 André Klapper 2013-02-23 11:22:44 UTC
No such folder "gnome-feedback" in http://git.gnome.org/browse/gnome-desktop/tree/desktop-docs , and blindly moving reports to different products and even setting a completely bogus version number (3.4) doesn't help.

OBSOLETE.