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
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 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
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, 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, -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, 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, -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
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
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
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, 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 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
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