Bug submission guidelines

Post here for help on using FreeCAD's graphical user interface (GUI).
Forum rules
and Helpful information
IMPORTANT: Please click here and read this first, before asking for help

Also, be nice to others! Read the FreeCAD code of conduct!
chrisb
Posts: 16935
Joined: Tue Mar 17, 2015 9:14 am

Re: Bug submission guidelines

Postby chrisb » Tue Oct 02, 2018 10:35 pm

Kunda1 wrote:
Tue Oct 02, 2018 10:23 pm
and I still think bolded text is a good way to go.
... whatever helps to improve awareness.
User avatar
sgrogan
Posts: 5210
Joined: Wed Oct 22, 2014 5:02 pm

Re: Bug submission guidelines

Postby sgrogan » Tue Oct 02, 2018 10:40 pm

chrisb wrote:
Tue Oct 02, 2018 9:59 pm
2. Discuss the problem on the forum first!
Maybe we could add an why? link?
I don't know the words, but, "help us triage your bug so it gets fixed. Developer time is precious" etc.?
User avatar
Kunda1
Posts: 4812
Joined: Thu Jan 05, 2017 9:03 pm

Re: Bug submission guidelines

Postby Kunda1 » Mon Oct 08, 2018 2:27 pm

sgrogan wrote:
Tue Oct 02, 2018 10:40 pm
chrisb wrote:
Tue Oct 02, 2018 9:59 pm
2. Discuss the problem on the forum first!
Maybe we could add an why? link?
I don't know the words, but, "help us triage your bug so it gets fixed. Developer time is precious" etc.?
I think this is also a valid request.
Do we have consensus on what I'm proposing in https://forum.freecadweb.org/viewtopic. ... 36#p259976
Want to contribute back to FC? Checkout:
#lowhangingfruit | Use the Source, Luke. | How to Help FreeCAD | How to report FC bugs and features
User avatar
NormandC
Posts: 18534
Joined: Sat Feb 06, 2010 9:52 pm
Location: Québec, Canada

Re: Bug submission guidelines

Postby NormandC » Mon Oct 08, 2018 6:34 pm

Fine with me.
chrisb
Posts: 16935
Joined: Tue Mar 17, 2015 9:14 am

Re: Bug submission guidelines

Postby chrisb » Mon Oct 08, 2018 8:18 pm

NormandC wrote:
Mon Oct 08, 2018 6:34 pm
Fine with me.
Me too.
User avatar
sgrogan
Posts: 5210
Joined: Wed Oct 22, 2014 5:02 pm

Re: Bug submission guidelines

Postby sgrogan » Mon Oct 08, 2018 8:35 pm

Kunda1 wrote:
Mon Oct 08, 2018 2:27 pm
Do we have consensus on what I'm proposing in https://forum.freecadweb.org/viewtopic. ... 36#p259976
I would tweak #2 as suggested by chrisb. Even if the user is sure, we want to test on other OS/Distros to refine the bug report.
User avatar
ooveif9
Posts: 35
Joined: Thu Mar 22, 2018 8:29 pm
Location: Weimar

Re: Bug submission guidelines

Postby ooveif9 » Sat Aug 03, 2019 5:45 pm

yorik wrote:
Sun Dec 29, 2013 9:48 pm

1. Make sure that what you found is a bug. The definition of a bug is this: Something that is not working, but for which you are sure that it should be working (for example it worked in the past, or it is advertised on the FreeCAD documentation wiki). Otherwise, it might be simply that what you want is not implemented, or maybe you are doing something wrong.
Please clarify your bug definition. If FreeCAD crashes because I do something wrong, is that a bug or not? Should it be reported? Thanks.
GeneFC
Posts: 1025
Joined: Sat Mar 19, 2016 3:36 pm
Location: Punta Gorda, FL

Re: Bug submission guidelines

Postby GeneFC » Sat Aug 03, 2019 9:25 pm

Following the directions in the first post of this topic is still the correct method for "bugs".

If you get to the third box, go ahead and create a topic in the Help fourm. The responders will either help find your error or will agree that the crash is really a bug. Don't go straight to the Mantis tracker before discussing on the forum.

A crash should never happen, whether due to user error or a bug. But of course crashes do happen because it is very difficult to predict every sort of error that a user might make.

Gene
chrisb
Posts: 16935
Joined: Tue Mar 17, 2015 9:14 am

Re: Bug submission guidelines

Postby chrisb » Sat Aug 03, 2019 10:08 pm

sgrogan wrote:
Tue Oct 02, 2018 10:40 pm
chrisb wrote:
Tue Oct 02, 2018 9:59 pm
2. Discuss the problem on the forum first!
Maybe we could add an why? link?
I don't know the words, but, "help us triage your bug so it gets fixed. Developer time is precious" etc.?
Proposal for point 2:

2. Discuss the problem on the forum first! This should be done before creating a ticket in the bugtracker, for several reasons: It may not be a bug after all and you will get advice how to proceed; developer time is precious and a discussion here in the forum will produce far better tickets; you may be offered a workaround until the bug is fixed.