Bug Reporting Workflow - Revision history

Moini: Keep this page as a document of our progress

2025-05-13T23:29:29Z

Keep this page as a document of our progress

← Older revision		Revision as of 23:29, 13 May 2025
Line 1:		Line 1:
			{{Outdated}}
			Most of the workflow problems discussed in this Wiki article have been resolved.

	== Issue Description ==		== Issue Description ==

Line 57:		Line 60:
	** Sift through the reports on launchpad, test them, and only move relevant bug reports manually. Inform users on reports deemed irrelevant to open up a new report in new location if they think the decision was wrong.		** Sift through the reports on launchpad, test them, and only move relevant bug reports manually. Inform users on reports deemed irrelevant to open up a new report in new location if they think the decision was wrong.
	** ... something else		** ... something else

			[[Category:Wiki Attic]]

Moini: Reverted edits by Adambelis (talk) to last revision by Moini

2025-05-13T23:26:06Z

Reverted edits by Adambelis (talk) to last revision by Moini

← Older revision		Revision as of 23:26, 13 May 2025
Line 1:		Line 1:
	= [https://inkscape.org/contribute/report-bugs/ '''~~HOW TO REPORT BUGS~~'''] =		== Issue Description ==

			* After the Inkscape project's move to GitLab for the hosting of its source code repository (and various other repositories), the project's bug tracker [https://bugs.launchpad.net/inkscape is still on launchpad]. As of February 22, 2018, there are 4748 open and 1826 new bugs listed.

			* Users are usually not guided in making their bug reports/feature requests, resulting in many unclear bug reports, duplicate reports and insecurity of what to do for the users, probably also in some bugs going unreported. There is no template, or a step-by-step instruction on launchpad for the minimum requirements of a good report. There is a [https://inkscape.org/en/contribute/report-bugs/ web page that describes the process]. Bryce has written up [https://gitlab.com/inkscape/vectors/general/uploads/5fd013b6e716f16ccc85f8620d49bbdf/friendly_feedback.txt a possible, ideal scenario for a bug workflow for Inkscape].

			* To report a bug, one needs to have an account on launchpad. The registration process for a launchpad account (via Ubuntu One) can seem deterrent to a user.

			* Bug reports are not currently systematically triaged, tagged, labelled or otherwise sorted. They can go unanswered completely. Feature requests and bug reports, as well as some usage errors and questions all end up in the same place, which in its current state is not welcoming to users nor to (possible new) developers, due to the sheer amount and the missing categorization. Launchpad provides a system to label feature requests as 'wishlist' items, and to add various kinds of tags to an issue.

			* There is a group of people who check new reports and try to help where they can, but they are not organized as a team, and not all of them seem to have permission to change a bug's importance or to milestone it for a specific release.

			* Several developers on the mailing list have expressed a wish to return to the pre-launchpad system of having separate places for bug reports and feature requests. If such a separation is established, there is an agreement that it's necessary to allow for easy moving of issues between the two trackers.

			* The disconnect between reports and code work makes it more difficult for developers to know about new bugs or to engage a possibly interested developer in the discussion about a bug. It also makes it harder to keep the bug tracker updated. Automatted closing of bug reports via commit message is no longer possible.

			* Some work on [https://github.com/doctormo/lpout moving bug reports from Launchpad to GitLab has been done], but has been given up due to the impossibility of attaching bug reports to non-existing users on the new platform. This would mean they do not get a message anymore when their report is worked on by someone, or someone has a question, but they would need to resubscribe. Extracting reports and metadata from launchpad works. A test account for adding new reports to GitLab has already been established.

			== Resources ==

			''[https://sourceforge.net/p/inkscape/mailman/inkscape-devel/thread/97cab7ef-a1f8-e995-3a0a-947f4760724d%40gmx.de/#msg36195892 Related Mailing list discussion]''

			''[https://gitlab.com/inkscape/vectors/general/issues/23#note_53572757 Related Vectors Team discussion]''

			[[File:Possible user feedback workflow.png]]<br> Bryce's proposed organizational diagram

			== Questions ==


			=== Bug report organization ===

			* Should bug reports and feature requests be kept in the same location?
			* Should there be separate places for unfiltered user requests (bugs, user questions and feature requests) and bug reports that are ready for a developer to take on?


			=== Bug reporting pathway ===

			* Should we establish a pathway for 'normal' users to get help in formulating their bug reports (and determining if their request actually is a bug)?
			* How could the technical implementation of such a pathway look?
			* Is there a software available that already fulfills those needs?
			** should be connectable to GitLab
			** could this just be a third gitlab tracker?
			** as a last resort, write our own

			* How could we encourage more contributors to help with such a pre-triage path?

			=== Location/transfer of bug reports ===

			* Where does the Inkscape project want to host its bug reports?
			** continue hosting at Launchpad
			** move them to GitLab
			** move them to a self-hosted site (then: which bug tracking program to use?)
			** move them to ...

			* If bug reports will be transferred, how will this be done?
			** Transfer all bug reports, inform users on launchpad programatically where their issue has been moved to
			** Sift through the reports on launchpad, test them, and only move relevant bug reports manually. Inform users on reports deemed irrelevant to open up a new report in new location if they think the decision was wrong.
			** ... something else

Adambelis: Replaced content with "= [https://inkscape.org/contribute/report-bugs/ '''HOW TO REPORT BUGS'''] ="

2025-05-13T09:07:58Z

Replaced content with "= [https://inkscape.org/contribute/report-bugs/ '''HOW TO REPORT BUGS'''] ="

← Older revision		Revision as of 09:07, 13 May 2025
Line 1:		Line 1:
	= [https://inkscape.org/contribute/report-bugs/ '''HOW TO REPORT BUGS'''] =		= [https://inkscape.org/contribute/report-bugs/ '''HOW TO REPORT BUGS'''] =














	~~{{Outdated}}~~

	~~== Issue Description ==~~

	* After the Inkscape project's move to GitLab for the hosting of its source code repository (and various other repositories), the project's bug tracker [https://bugs.launchpad.net/inkscape is still on launchpad]. As of February 22, 2018, there are 4748 open and 1826 new bugs listed.

	* Users are usually not guided in making their bug reports/feature requests, resulting in many unclear bug reports, duplicate reports and insecurity of what to do for the users, probably also in some bugs going unreported. There is no template, or a step-by-step instruction on launchpad for the minimum requirements of a good report. There is a [https://inkscape.org/en/contribute/report-bugs/ web page that describes the process]. Bryce has written up [https://gitlab.com/inkscape/vectors/general/uploads/5fd013b6e716f16ccc85f8620d49bbdf/friendly_feedback.txt a possible, ideal scenario for a bug workflow for Inkscape].

	* To report a bug, one needs to have an account on launchpad. The registration process for a launchpad account (via Ubuntu One) can seem deterrent to a user.

	* Bug reports are not currently systematically triaged, tagged, labelled or otherwise sorted. They can go unanswered completely. Feature requests and bug reports, as well as some usage errors and questions all end up in the same place, which in its current state is not welcoming to users nor to (possible new) developers, due to the sheer amount and the missing categorization. Launchpad provides a system to label feature requests as 'wishlist' items, and to add various kinds of tags to an issue.

	* There is a group of people who check new reports and try to help where they can, but they are not organized as a team, and not all of them seem to have permission to change a bug's importance or to milestone it for a specific release.

	* Several developers on the mailing list have expressed a wish to return to the pre-launchpad system of having separate places for bug reports and feature requests. If such a separation is established, there is an agreement that it's necessary to allow for easy moving of issues between the two trackers.

	* The disconnect between reports and code work makes it more difficult for developers to know about new bugs or to engage a possibly interested developer in the discussion about a bug. It also makes it harder to keep the bug tracker updated. Automatted closing of bug reports via commit message is no longer possible.

	* Some work on [https://github.com/doctormo/lpout moving bug reports from Launchpad to GitLab has been done], but has been given up due to the impossibility of attaching bug reports to non-existing users on the new platform. This would mean they do not get a message anymore when their report is worked on by someone, or someone has a question, but they would need to resubscribe. Extracting reports and metadata from launchpad works. A test account for adding new reports to GitLab has already been established.

	~~== Resources ==~~

	~~''[https://sourceforge.net/p/inkscape/mailman/inkscape-devel/thread/97cab7ef-a1f8-e995-3a0a-947f4760724d%40gmx.de/#msg36195892 Related Mailing list discussion]''~~

	~~''[https://gitlab.com/inkscape/vectors/general/issues/23#note_53572757 Related Vectors Team discussion]''~~

	~~[[File:Possible user feedback workflow.png]]<br> Bryce's proposed organizational diagram~~

	~~== Questions ==~~


	~~=== Bug report organization ===~~

	* Should bug reports and feature requests be kept in the same location?
	* Should there be separate places for unfiltered user requests (bugs, user questions and feature requests) and bug reports that are ready for a developer to take on?


	~~=== Bug reporting pathway ===~~

	* Should we establish a pathway for 'normal' users to get help in formulating their bug reports (and determining if their request actually is a bug)?
	* How could the technical implementation of such a pathway look?
	* Is there a software available that already fulfills those needs?
	** should be connectable to GitLab
	** could this just be a third gitlab tracker?
	** as a last resort, write our own

	* How could we encourage more contributors to help with such a pre-triage path?

	~~=== Location/transfer of bug reports ===~~

	* Where does the Inkscape project want to host its bug reports?
	** continue hosting at Launchpad
	** move them to GitLab
	** move them to a self-hosted site (then: which bug tracking program to use?)
	** move them to ...

	* If bug reports will be transferred, how will this be done?
	** Transfer all bug reports, inform users on launchpad programatically where their issue has been moved to
	** Sift through the reports on launchpad, test them, and only move relevant bug reports manually. Inform users on reports deemed irrelevant to open up a new report in new location if they think the decision was wrong.
	** ... something else

Adambelis at 09:07, 13 May 2025

2025-05-13T09:07:14Z

← Older revision		Revision as of 09:07, 13 May 2025
Line 1:		Line 1:
	{{Outdated}}		= [https://inkscape.org/contribute/report-bugs/ '''HOW TO REPORT BUGS'''] =














			{{Outdated}}

	== Issue Description ==		== Issue Description ==

Adambelis at 11:03, 21 May 2024

2024-05-21T11:03:51Z

← Older revision		Revision as of 11:03, 21 May 2024
Line 1:		Line 1:
			{{Outdated}}
	== Issue Description ==		== Issue Description ==

Moini: /* Resources */ fix it again, this time correctly.

2018-02-22T02:52:36Z

Resources: fix it again, this time correctly.

← Older revision		Revision as of 02:52, 22 February 2018
Line 21:		Line 21:
	''[https://sourceforge.net/p/inkscape/mailman/inkscape-devel/thread/97cab7ef-a1f8-e995-3a0a-947f4760724d%40gmx.de/#msg36195892 Related Mailing list discussion]''		''[https://sourceforge.net/p/inkscape/mailman/inkscape-devel/thread/97cab7ef-a1f8-e995-3a0a-947f4760724d%40gmx.de/#msg36195892 Related Mailing list discussion]''

	''[https://gitlab.com/inkscape/vectors/general/issues/25 Related Vectors Team discussion]''		''[https://gitlab.com/inkscape/vectors/general/issues/23#note_53572757 Related Vectors Team discussion]''

	[[File:Possible user feedback workflow.png]]<br> Bryce's proposed organizational diagram		[[File:Possible user feedback workflow.png]]<br> Bryce's proposed organizational diagram

Moini: /* Resources */ Fix link

2018-02-22T02:50:36Z

Resources: Fix link

← Older revision		Revision as of 02:50, 22 February 2018
Line 21:		Line 21:
	''[https://sourceforge.net/p/inkscape/mailman/inkscape-devel/thread/97cab7ef-a1f8-e995-3a0a-947f4760724d%40gmx.de/#msg36195892 Related Mailing list discussion]''		''[https://sourceforge.net/p/inkscape/mailman/inkscape-devel/thread/97cab7ef-a1f8-e995-3a0a-947f4760724d%40gmx.de/#msg36195892 Related Mailing list discussion]''

	''[https://gitlab.com/inkscape/vectors/general/issues/23 Related Vectors Team discussion]''		''[https://gitlab.com/inkscape/vectors/general/issues/25 Related Vectors Team discussion]''

	[[File:Possible user feedback workflow.png]]<br> Bryce's proposed organizational diagram		[[File:Possible user feedback workflow.png]]<br> Bryce's proposed organizational diagram

Moini: /* Bug reporting pathway */ fix a fix

2018-02-22T01:34:55Z

Bug reporting pathway: fix a fix

← Older revision		Revision as of 01:34, 22 February 2018
Line 36:		Line 36:
	=== Bug reporting pathway ===		=== Bug reporting pathway ===

	* Should we establish a pathway for 'normal' users to get help in formulating their bug reports (and determining if their request actually is a ~~report~~)?		* Should we establish a pathway for 'normal' users to get help in formulating their bug reports (and determining if their request actually is a bug)?
	* How could the technical implementation of such a pathway look?		* How could the technical implementation of such a pathway look?
	* Is there a software available that already fulfills those needs?		* Is there a software available that already fulfills those needs?
Line 44:		Line 44:

	* How could we encourage more contributors to help with such a pre-triage path?		* How could we encourage more contributors to help with such a pre-triage path?


	=== Location/transfer of bug reports ===		=== Location/transfer of bug reports ===

Moini: /* Resources */ grammar

2018-02-22T01:33:51Z

Resources: grammar

← Older revision		Revision as of 01:33, 22 February 2018
Line 23:		Line 23:
	''[https://gitlab.com/inkscape/vectors/general/issues/23 Related Vectors Team discussion]''		''[https://gitlab.com/inkscape/vectors/general/issues/23 Related Vectors Team discussion]''

	[[File:Possible user feedback workflow.png]]<br> Bryce's ~~proposal~~ organizational diagram		[[File:Possible user feedback workflow.png]]<br> Bryce's proposed organizational diagram

	== Questions ==		== Questions ==

Moini: /* Issue Description */ type

2018-02-22T01:33:22Z

Issue Description: type

← Older revision		Revision as of 01:33, 22 February 2018
Line 15:		Line 15:
	* The disconnect between reports and code work makes it more difficult for developers to know about new bugs or to engage a possibly interested developer in the discussion about a bug. It also makes it harder to keep the bug tracker updated. Automatted closing of bug reports via commit message is no longer possible.		* The disconnect between reports and code work makes it more difficult for developers to know about new bugs or to engage a possibly interested developer in the discussion about a bug. It also makes it harder to keep the bug tracker updated. Automatted closing of bug reports via commit message is no longer possible.

	* Some work on [https://github.com/doctormo/lpout moving bug reports from Launchpad to GitLab has been done], but has been given up due to the impossibility of attaching bug reports to non-existing users on the new platform. This would mean they do not get a message anymore when their report is worked on by someone, or someone has a question, but they would need to resubscribe. Extracting reports and ~~metadate~~ from launchpad works. A test account for adding new reports to GitLab has already been established.		* Some work on [https://github.com/doctormo/lpout moving bug reports from Launchpad to GitLab has been done], but has been given up due to the impossibility of attaching bug reports to non-existing users on the new platform. This would mean they do not get a message anymore when their report is worked on by someone, or someone has a question, but they would need to resubscribe. Extracting reports and metadata from launchpad works. A test account for adding new reports to GitLab has already been established.

	== Resources ==		== Resources ==