Re: [Development] "Examples and demos" component in Jira (QTBUG project)

2020-09-11 Thread Kai Köhne
> -Ursprüngliche Nachricht-
> Von: Development  Im Auftrag von
> Santtu Ahonen
> Betreff: Re: [Development] "Examples and demos" component in Jira (QTBUG
> project)
> 
> Retiring the component would be a massive loss of data and alignment
> between projects. This before retirement proposal we should have a plan on
> how to manage this area properly. Granted, this is a messy area without clear
> ownership thus we can argue on what team / who should be the owner of the
> component.
>
> In fact the component combines two different use cases (Examples and
> Demos) and it is not helping that different Qt projects have differently named
> components for the same overall use case.

Well, then I'm wondering what the loss of alignment is 😊

> In Product Management we use quite a lot of these Demo components to
> track demos we need to create for specific customer verticals or events,
> marketing needs etc. Our master board is here:
> https://bugreports.qt.io/secure/RapidBoard.jspa?rapidView=83

The filter query for this very board is: 

component in (Demo, Demos, "Demo Design (internal)", "Demo Implementation 
(internal)", DemosAndPresentations, "Examples and Demos", Examples) OR labels 
in (example, examples, Examples)

So the fix for QTBUG is easy: Tag the JIRA issues you're interested in in QTBUG 
with 'example' label. Or even better, extend the query and use a more 
descriptive label like 'pm_demo'. Because I actually doubt that the various 
bugs we have currently reported against the 'Examples and Demos' component are 
really regularly reviewed by PM.

> If we touch this area I'd be welcoming on splitting the Examples and Demos in
> to two separate use cases but this is not an issue for just QTBUG project, 
> this
> goes across the board and over several projects. 

If we ever get properly maintained demos into QTBUG back (with clear 
responsibility) then I'm certainly not against it.

Regards

Kai
___
Development mailing list
Development@qt-project.org
https://lists.qt-project.org/listinfo/development


Re: [Development] "Examples and demos" component in Jira (QTBUG project)

2020-09-10 Thread Santtu Ahonen
Retiring the component would be a massive loss of data and alignment between 
projects. This before retirement proposal we should have a plan on how to 
manage this area properly. Granted, this is a messy area without clear 
ownership thus we can argue on what team / who should be the owner of the 
component.

In fact the component combines two different use cases (Examples and Demos) and 
it is not helping that different Qt projects have differently named components 
for the same overall use case. 

In Product Management we use quite a lot of these Demo components to track 
demos we need to create for specific customer verticals or events, marketing 
needs etc. Our master board is here: 
https://bugreports.qt.io/secure/RapidBoard.jspa?rapidView=83 

If we touch this area I'd be welcoming on splitting the Examples and Demos in 
to two separate use cases but this is not an issue for just QTBUG project, this 
goes across the board and over several projects. Doing this will be quite a big 
one time effort but should improve the content accuracy. 

Regards, Stu
-- 
Product Owner, Qt Platforms
+358408031045 / santtu.aho...@qt.io



-Original Message-
From: Development  On Behalf Of Paul Wicking
Sent: maanantai 7. syyskuuta 2020 13.27
To: Qt development mailing list ; Product 
Management 
Cc: inter...@qt-project.org
Subject: [Development] "Examples and demos" component in Jira (QTBUG project)

Hi all,

Documentation engineers are most often not the right assignee for example bugs, 
which end up going stale. I propose to retire the "Examples and demos” 
component.

Bugs in examples are often discovered during package testing, or soon after 
release of a new minor version. In most cases, documentation engineers are the 
wrong assignees for these issues. The QTBUG project requires that all 
components have a default assignee, and Jira chooses the default assignee for 
an issue from its components in alphabetical order. Thus, most issues reported 
against the “Examples and demos” component end up with the Qt Documentation 
Team as the assignee, even if the reporter or triage team adds the component 
the code belongs to. The result is that these issues often receive almost as 
little attention as if they had been without an assignee in the first place. 
They go stale.

I have discussed this problem with the documentation engineers and some of the 
R&D area leads in TQtC. We believe the component mostly provides 
meta-information. That can be achieved by other means that do not require a 
default assignee. Therefore, we think it’s best to retire the component. The 
Documentation Infrastructure team will triage all "examples and demos” bugs 
during this week, with the goal of assigning the correct components and/or 
teams/maintainers to these tasks. When all tasks are triaged, the component 
will be retired. This means it will not be available when creating a new issue, 
and it will not impact our archives.

--
Paul Wicking
R&D Manager

The Qt Company
Sandakerveien 116
0484, Oslo, Norway
paul.wick...@qt.io
https://qt.io

The Future is Written with Qt
--

___
Development mailing list
Development@qt-project.org
https://lists.qt-project.org/listinfo/development
___
Development mailing list
Development@qt-project.org
https://lists.qt-project.org/listinfo/development


Re: [Development] "Examples and demos" component in Jira (QTBUG project)

2020-09-09 Thread Topi Reiniö
+1. Going through the open bugs under 'Examples and Demos', it was clear that 
out of 149 items, only two fell clearly within the realm of documentation or 
documentation infrastructure, and all were better off with a specific module or 
area as a component. There's also the risk of critical issues not receiving 
immediate attention if they are discovered via an example and only reported 
against that component. We're better off without it.

\topi

From: Development  on behalf of Paul 
Wicking 
Sent: Monday, September 7, 2020 12:27 PM
To: Qt development mailing list ; Product 
Management 
Cc: inter...@qt-project.org 
Subject: [Development] "Examples and demos" component in Jira (QTBUG project)

Hi all,

Documentation engineers are most often not the right assignee for example bugs, 
which end up going stale. I propose to retire the "Examples and demos” 
component.

Bugs in examples are often discovered during package testing, or soon after 
release of a new minor version. In most cases, documentation engineers are the 
wrong assignees for these issues. The QTBUG project requires that all 
components have a default assignee, and Jira chooses the default assignee for 
an issue from its components in alphabetical order. Thus, most issues reported 
against the “Examples and demos” component end up with the Qt Documentation 
Team as the assignee, even if the reporter or triage team adds the component 
the code belongs to. The result is that these issues often receive almost as 
little attention as if they had been without an assignee in the first place. 
They go stale.

I have discussed this problem with the documentation engineers and some of the 
R&D area leads in TQtC. We believe the component mostly provides 
meta-information. That can be achieved by other means that do not require a 
default assignee. Therefore, we think it’s best to retire the component. The 
Documentation Infrastructure team will triage all "examples and demos” bugs 
during this week, with the goal of assigning the correct components and/or 
teams/maintainers to these tasks. When all tasks are triaged, the component 
will be retired. This means it will not be available when creating a new issue, 
and it will not impact our archives.

--
Paul Wicking
R&D Manager

The Qt Company
Sandakerveien 116
0484, Oslo, Norway
paul.wick...@qt.io
https://qt.io

The Future is Written with Qt
--

___
Development mailing list
Development@qt-project.org
https://lists.qt-project.org/listinfo/development
___
Development mailing list
Development@qt-project.org
https://lists.qt-project.org/listinfo/development


[Development] "Examples and demos" component in Jira (QTBUG project)

2020-09-07 Thread Paul Wicking
Hi all,

Documentation engineers are most often not the right assignee for example bugs, 
which end up going stale. I propose to retire the "Examples and demos” 
component.

Bugs in examples are often discovered during package testing, or soon after 
release of a new minor version. In most cases, documentation engineers are the 
wrong assignees for these issues. The QTBUG project requires that all 
components have a default assignee, and Jira chooses the default assignee for 
an issue from its components in alphabetical order. Thus, most issues reported 
against the “Examples and demos” component end up with the Qt Documentation 
Team as the assignee, even if the reporter or triage team adds the component 
the code belongs to. The result is that these issues often receive almost as 
little attention as if they had been without an assignee in the first place. 
They go stale.

I have discussed this problem with the documentation engineers and some of the 
R&D area leads in TQtC. We believe the component mostly provides 
meta-information. That can be achieved by other means that do not require a 
default assignee. Therefore, we think it’s best to retire the component. The 
Documentation Infrastructure team will triage all "examples and demos” bugs 
during this week, with the goal of assigning the correct components and/or 
teams/maintainers to these tasks. When all tasks are triaged, the component 
will be retired. This means it will not be available when creating a new issue, 
and it will not impact our archives.

--
Paul Wicking
R&D Manager

The Qt Company
Sandakerveien 116
0484, Oslo, Norway
paul.wick...@qt.io
https://qt.io

The Future is Written with Qt
--

___
Development mailing list
Development@qt-project.org
https://lists.qt-project.org/listinfo/development