RE: Proposed reorganization of documentation bug reporting
Am Donnerstag, den 20.05.2010, 08:58 +0200 schrieb jarmo.ti...@nokia.com: > Ok somebody then has just setup a "private" Bugzilla product for > his/her private bug reports. I think it is then better not to touch > this product at all in case that somebody still uses this... Yes, I use it (in order to reflect internal structure). > As summary I am now happy with the new documentation structure in Maemo > Bugzilla. Great to hear that. andre -- Andre Klapper (maemo.org bugmaster) ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Hi, > -Original Message- > From: ext Andre Klapper [mailto:aklap...@openismus.com] > Sent: 18 May, 2010 17:48 > To: Dave Neary > Cc: Tikka Jarmo (Nokia-D/Helsinki); maemo-developers@maemo.org; maemo- > commun...@maemo.org > Subject: Re: Proposed reorganization of documentation bug reporting > > Am Dienstag, den 18.05.2010, 13:42 +0200 schrieb Dave Neary: > > jarmo.ti...@nokia.com wrote: > > Looking at this: http://is.gd/cevlF it appears that these bugs are > being > > opened against applications which do not follow UI specifications, > > rather than being documentation bugs. > > No, as these reports are about issues in the (mostly non-public) UI > specifications of applications. > It's correct that they have nothing to do with public documentation. Ok somebody then has just setup a "private" Bugzilla product for his/her private bug reports. I think it is then better not to touch this product at all in case that somebody still uses this... As summary I am now happy with the new documentation structure in Maemo Bugzilla. Cheers, //Jarmo > > andre > -- > Andre Klapper (maemo.org bugmaster) ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Hi again, > -Original Message- > From: Tikka Jarmo (Nokia-D/Helsinki) > Sent: 18 May, 2010 15:01 > > I need to stop replying to my own emails soon but those UI Guides > disappeared again :). > > We continue investigating which server in our cluster has not deployed > those UI guides properly. We found those problematic servers and they were redeployed couple of hours ago. Hildon 2.2 UI documents should be now fine in Maemo Info Center. Sorry about the trouble this may have caused. Cheers, //Jarmo > > Cheers, > //Jarmo > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: Proposed reorganization of documentation bug reporting
Am Dienstag, den 18.05.2010, 13:42 +0200 schrieb Dave Neary: > jarmo.ti...@nokia.com wrote: > Looking at this: http://is.gd/cevlF it appears that these bugs are being > opened against applications which do not follow UI specifications, > rather than being documentation bugs. No, as these reports are about issues in the (mostly non-public) UI specifications of applications. It's correct that they have nothing to do with public documentation. andre -- Andre Klapper (maemo.org bugmaster) ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Yo. Am Dienstag, den 18.05.2010, 12:14 +0200 schrieb jarmo.ti...@nokia.com: > What I am still wondering is "UI Specification" product under "Maemo > Official Platform" classification here: > https://bugs.maemo.org/enter_bug.cgi?classification=Maemo%20Official% > 20Platform > Those UI specs are now released as separate tutorials No. Two UI specs were released, but not all the other internal UI Specs. But that's up to Nokia and not my business... > * > Under classification "Websites" there is wrong description for > "Maemo.org Website" product saying that documentation bugs should be > filed under "Development Platform" classification when they now should > be filed under "Documentation" classification. Thanks! Fixed. andre -- Andre Klapper (maemo.org bugmaster) ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Hi, > -Original Message- > From: Dave Neary [mailto:nea...@gmail.com] On Behalf Of ext Dave Neary > Sent: 18 May, 2010 14:42 > Subject: Re: Proposed reorganization of documentation bug reporting > > Hi, > > jarmo.ti...@nokia.com wrote: > > What I am still wondering is "UI Specification" product under "Maemo > > Official Platform" classification here: > > > https://bugs.maemo.org/enter_bug.cgi?classification=Maemo%20Official%20 > Platform > > Looking at this: http://is.gd/cevlF it appears that these bugs are > being > opened against applications which do not follow UI specifications, > rather than being documentation bugs. Thanks, I did not check those actual bugs this product has. > > I suggest leaving them there - and if people really feel there is > confusion, changing the name of the component to just "UI". This is ok for me as these are really Maemo application bugs not documentation bugs. Our UI team together with Maemo community can decide do they want to have this product here or should these bugs be reported to applications that do not follow specifications. Cheers, //Jarmo > > Cheers, > Dave. > > -- > maemo.org docsmaster > Email: dne...@maemo.org > Jabber: bo...@jabber.org ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Hi, I need to stop replying to my own emails soon but those UI Guides disappeared again :). We continue investigating which server in our cluster has not deployed those UI guides properly. Cheers, //Jarmo > -Original Message- > From: Tikka Jarmo (Nokia-D/Helsinki) > Sent: 18 May, 2010 14:55 > To: 'ext Andre Klapper' > Cc: 'maemo-developers@maemo.org'; 'dne...@maemo.org'; 'maemo- > commun...@maemo.org'; Hamalainen Aapi (EXT-Nomovok/Helsinki); 'ext > Saine Jussi' > Subject: RE: Proposed reorganization of documentation bug reporting > > Hi again, > > > -Original Message- > > From: Tikka Jarmo (Nokia-D/Helsinki) > > Sent: 18 May, 2010 13:15 > > > > Those UI specs are now released as separate tutorials "Maemo Hildon > 2.2 > > UI Guide" and "Maemo Hildon 2.2 UI Widget Guide" in Maemo Info > Center. > > See http://library.maemodocs.nokia.com/fremantle/index.jsp?nav=/1 > > > > Bugs for these Hildon guides should be reported under "Documentation" > > classification to the "Tutorials" product. > > > > NOTICE there seems to be some hickup either in Maemo Info Center > > deployment for our Info Center clusters or in Akamai world wide cache > > network configuration because I cannot find those docs from Info > Center > > anymore. They are anyhow still downloadable from here > > > http://library.maemodocs.nokia.com/documents/fremantle/Maemo_5_SDK_Docu > > mentation/ > > > > I will try to check which problem this is and fix it asap. > > Those Hildon 2.2. UI docs are back again in Info Center. > http://library.maemodocs.nokia.com/fremantle/index.jsp?nav=/1 > > We are still investigating what actually was wrong in Info Center to be > able to prevent this to happen again. Problem was not related to Akamai > cache servers but most probably Info Center cluster deployment or our > loadbalancer configurations was somewhat broken. > > Anyhow docs are back again for people to file bugs... > > Cheers, > //JAmro ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Hi again, > -Original Message- > From: Tikka Jarmo (Nokia-D/Helsinki) > Sent: 18 May, 2010 13:15 > > Those UI specs are now released as separate tutorials "Maemo Hildon 2.2 > UI Guide" and "Maemo Hildon 2.2 UI Widget Guide" in Maemo Info Center. > See http://library.maemodocs.nokia.com/fremantle/index.jsp?nav=/1 > > Bugs for these Hildon guides should be reported under "Documentation" > classification to the "Tutorials" product. > > NOTICE there seems to be some hickup either in Maemo Info Center > deployment for our Info Center clusters or in Akamai world wide cache > network configuration because I cannot find those docs from Info Center > anymore. They are anyhow still downloadable from here > http://library.maemodocs.nokia.com/documents/fremantle/Maemo_5_SDK_Docu > mentation/ > > I will try to check which problem this is and fix it asap. Those Hildon 2.2. UI docs are back again in Info Center. http://library.maemodocs.nokia.com/fremantle/index.jsp?nav=/1 We are still investigating what actually was wrong in Info Center to be able to prevent this to happen again. Problem was not related to Akamai cache servers but most probably Info Center cluster deployment or our loadbalancer configurations was somewhat broken. Anyhow docs are back again for people to file bugs... Cheers, //JAmro ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: Proposed reorganization of documentation bug reporting
Hi, jarmo.ti...@nokia.com wrote: > What I am still wondering is "UI Specification" product under "Maemo > Official Platform" classification here: > https://bugs.maemo.org/enter_bug.cgi?classification=Maemo%20Official%20Platform Looking at this: http://is.gd/cevlF it appears that these bugs are being opened against applications which do not follow UI specifications, rather than being documentation bugs. I suggest leaving them there - and if people really feel there is confusion, changing the name of the component to just "UI". Cheers, Dave. -- maemo.org docsmaster Email: dne...@maemo.org Jabber: bo...@jabber.org ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Hi again, > From: Tikka Jarmo (Nokia-D/Helsinki) > I will check new structure today or tomorrow. I just went through new documentation structure in Maemo Bugzilla. Actual structure under "Documentation" classification looks fine for me. https://bugs.maemo.org/enter_bug.cgi?classification=Documentation * What I am still wondering is "UI Specification" product under "Maemo Official Platform" classification here: https://bugs.maemo.org/enter_bug.cgi?classification=Maemo%20Official%20Platform Those UI specs are now released as separate tutorials "Maemo Hildon 2.2 UI Guide" and "Maemo Hildon 2.2 UI Widget Guide" in Maemo Info Center. See http://library.maemodocs.nokia.com/fremantle/index.jsp?nav=/1. Bugs for these Hildon guides should be reported under "Documentation" classification to the "Tutorials" product. NOTICE there seems to be some hickup either in Maemo Info Center deployment for our Info Center clusters or in Akamai world wide cache network configuration because I cannot find those docs from Info Center anymore. They are anyhow still downloadable from here http://library.maemodocs.nokia.com/documents/fremantle/Maemo_5_SDK_Documentation/ I will try to check which problem this is and fix it asap. * Under classification "Websites" there is wrong description for "Maemo.org Website" product saying that documentation bugs should be filed under "Development Platform" classification when they now should be filed under "Documentation" classification. Cheers, //Jarmo ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Hi, And thanks a lot about cleaning documentation structure in Maemo Bugzilla. Having some classification in bug reports makes it much easier to go reports through and find open bug reports for some specific documents. > -Original Message- > From: ext Andre Klapper [mailto:aklap...@openismus.com] > Sent: 17 May, 2010 17:11 > To: Tikka Jarmo (Nokia-D/Helsinki) > Cc: maemo-developers@maemo.org; dne...@maemo.org; maemo- > commun...@maemo.org > Subject: RE: Proposed reorganization of documentation bug reporting > > Am Freitag, den 23.04.2010, 07:52 +0200 schrieb jarmo.ti...@nokia.com: > > > Am Dienstag, den 20.04.2010, 07:37 +0200 schrieb > jarmo.ti...@nokia.com: > > > > Any progress on this maemo.org Bugzilla reorganization for > > > > documentation bugs? > > "Documentation" is now centralized in bugs.maemo.org: > https://bugs.maemo.org/enter_bug.cgi?classification=Documentation > > Currently there are no Default Assignees set. > Changes can be tracked by adding the (virtual) "Default QA contact" to > your watchlist. See the corresponding subpages at > https://bugs.maemo.org/describecomponents.cgi and > http://blogs.gnome.org/aklapper/2008/12/18/watching-products-in- > maemoorg-bugzilla/for more information. > > As I killed the "Documentation" component in the "Developer platform" > product I manually sorted recent tickets (version 5.*) into the five > new products in the new Documentation classification. Good. > > I dumped the backlog (Documentation reports for earlier version) into > "Developer Guide" which is incorrect in some cases. > That was a trade-off (I won't spend hours sorting out new correct > products for stuff from three years ago that nobody is interested in). > I kept all Version and Target Milestone information though. I try to find time to go these old documentation bugs through and set their statuses (WONTFIX if nothing else) so that they just do not stay new or open there. > > For any further changes, corrections etc please contact me. I will check new structure today or tomorrow. Cheers, //Jarmo > > andre > -- > Andre Klapper (maemo.org bugmaster) ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Am Freitag, den 23.04.2010, 07:52 +0200 schrieb jarmo.ti...@nokia.com: > > Am Dienstag, den 20.04.2010, 07:37 +0200 schrieb jarmo.ti...@nokia.com: > > > Any progress on this maemo.org Bugzilla reorganization for > > > documentation bugs? "Documentation" is now centralized in bugs.maemo.org: https://bugs.maemo.org/enter_bug.cgi?classification=Documentation Currently there are no Default Assignees set. Changes can be tracked by adding the (virtual) "Default QA contact" to your watchlist. See the corresponding subpages at https://bugs.maemo.org/describecomponents.cgi and http://blogs.gnome.org/aklapper/2008/12/18/watching-products-in-maemoorg-bugzilla/ for more information. As I killed the "Documentation" component in the "Developer platform" product I manually sorted recent tickets (version 5.*) into the five new products in the new Documentation classification. I dumped the backlog (Documentation reports for earlier version) into "Developer Guide" which is incorrect in some cases. That was a trade-off (I won't spend hours sorting out new correct products for stuff from three years ago that nobody is interested in). I kept all Version and Target Milestone information though. For any further changes, corrections etc please contact me. andre -- Andre Klapper (maemo.org bugmaster) ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Hi, > -Original Message- > From: ext Andre Klapper [mailto:aklap...@openismus.com] > Sent: 22 April, 2010 15:54 > To: maemo-developers@maemo.org; Tikka Jarmo (Nokia-D/Helsinki); > dne...@maemo.org > Subject: RE: Proposed reorganization of documentation bug reporting > > Am Dienstag, den 20.04.2010, 07:37 +0200 schrieb jarmo.ti...@nokia.com: > > Any progress on this maemo.org Bugzilla reorganization for > > documentation bugs? > > I'm still a bit reluctant as I would like to see latest comments and > concerns answered first. > Andrew Flegg commented on the current separation and workflows are not > totally clear yet (as per Dave Neary's questions), but if everybody > says > "Go ahead!" I can do the reorganization in maemo.org Bugzilla later > this week. I thought that I had answered all open questions related to this proposal. The discussion in this mailing list has been minimal so I have not noticed any new questions. Do you (or somebody else) have any specific questions/concerns in your mind? > > (One more comment below this quote, please scroll down.) Actually below is one concern so I try to answer it :). > > > > > 1. Create a top classification named Documentation listed at > > https://bugs.maemo.org/enter_bug.cgi > > > > > > > > 2. Create the following products/subcomponents: > > > * Device User Guides & Help > > > * documents delivered together with device or device sales box > > > * Developer Guides > > > * maemo.org wiki http://wiki.maemo.org/Documentation/ > > > * reviewed version in Maemo Info Center > > > http://library.maemodocs.nokia.com/ > > > * Tutorials > > > * maemo.org wiki http://wiki.maemo.org/Documentation/ > > > * reviewed versions in Maemo Info Center > > > http://library.maemodocs.nokia.com/ > > > * API Documents > > > * from sources delivered from maemo.org SDK repositories > > > http://repository.maemo.org/ > > > * reviewed versions in Maemo Info Center > > > http://library.maemodocs.nokia.com/ > > > * Example Applications > > > * from MaemoExamples Garage project > > > http://vcs.maemo.org/svn/maemoexamples/tags/ > > > > > > > Bugs reported against Documentation->API docs should be moved to > the > > > > product they're being reported against with the "docs" keyword as > we > > > do > > > > now - this will make two potential places to record API bugs, but > I > > > > think this is OK. > > So "API Documents" is just a placeholder and should have a component > "Please avoid filing reports here. File them against the specific > product/component and add the "docs" keyword instead." ? API documents are somewhat problematic because: 1. if problems they need to be fixed to the source code and regenerated (only Nokia and team responsible of that specific component can fix this unless somebody wants to take upstream approach and wait until doc fix from upstream gets to the Maemo). 2. it has proven to be difficult for people to map from API document to the actual technology component in Maemo.org Bugzilla mainly because we do not have all technology components defined in Bugzilla :) These are the reasons I propose generic API document component to the Bugzilla that somebody who knows into what technology component possible bug reports must be moved or can even create new components to the Bugzilla. If somebody knows for what component API doc bugs should be created (and that component exists in Bugzilla :) that is the preferred way to file these bugs. Cheers, //Jarmo > > > andre > -- > Andre Klapper (maemo.org bugmaster) ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
RE: Proposed reorganization of documentation bug reporting
Am Dienstag, den 20.04.2010, 07:37 +0200 schrieb jarmo.ti...@nokia.com: > Any progress on this maemo.org Bugzilla reorganization for > documentation bugs? I'm still a bit reluctant as I would like to see latest comments and concerns answered first. Andrew Flegg commented on the current separation and workflows are not totally clear yet (as per Dave Neary's questions), but if everybody says "Go ahead!" I can do the reorganization in maemo.org Bugzilla later this week. (One more comment below this quote, please scroll down.) > > > 1. Create a top classification named Documentation listed at > https://bugs.maemo.org/enter_bug.cgi > > > > > > 2. Create the following products/subcomponents: > > * Device User Guides & Help > > * documents delivered together with device or device sales box > > * Developer Guides > > * maemo.org wiki http://wiki.maemo.org/Documentation/ > > * reviewed version in Maemo Info Center > > http://library.maemodocs.nokia.com/ > > * Tutorials > > * maemo.org wiki http://wiki.maemo.org/Documentation/ > > * reviewed versions in Maemo Info Center > > http://library.maemodocs.nokia.com/ > > * API Documents > > * from sources delivered from maemo.org SDK repositories > > http://repository.maemo.org/ > > * reviewed versions in Maemo Info Center > > http://library.maemodocs.nokia.com/ > > * Example Applications > > * from MaemoExamples Garage project > > http://vcs.maemo.org/svn/maemoexamples/tags/ > > > > > Bugs reported against Documentation->API docs should be moved to the > > > product they're being reported against with the "docs" keyword as we > > do > > > now - this will make two potential places to record API bugs, but I > > > think this is OK. So "API Documents" is just a placeholder and should have a component "Please avoid filing reports here. File them against the specific product/component and add the "docs" keyword instead." ? andre -- Andre Klapper (maemo.org bugmaster) ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
