Changes

From SME Server
Jump to navigationJump to search
no edit summary
Line 6: Line 6:     
https://gist.github.com/reetp/a66149d5f060f260643a353ca7067a98
 
https://gist.github.com/reetp/a66149d5f060f260643a353ca7067a98
 +
 +
The XY Info problem
 +
 +
http://xyproblem.info/
 +
 +
Tell us about the problem you were originally trying to solve, not the problem that you are experiencing right now.
 +
 +
Frequently the one you are experiencing now is the result of not understanding or being able to fix the original issue.
 +
 +
To report the issue make sure you are prepared. Supply the basic information required below under History. It saves a lot of time and effort.
 +
 +
Remember, if you phoned the garage about a problem with your car and you just said 'it runs funny sometimes' what would they ask you? Make, model, age... etc.
 +
 +
This is no different.
 +
 +
Be honest about the history even, if you are embarrassed. Two reasons:
 +
 +
1. It will make it far quicker and easier to give you a solution
 +
2. The people you are asking are likely to work out what you did eventually
 +
 +
Remember that the people who are likely to help you are all volunteers. They do not ask questions just for fun, or to make you angry.
 +
 +
Remember that you are the one with the problem, not them. You are asking them because you don't know or understand in the hop that they do. Don't abuse that position. You may find that you suddenly run out of help.
 +
 +
They also might tell you something that you do not want to hear. That does not make them wrong.
 +
 +
More reading:
    
How to Report Bugs Effectively
 
How to Report Bugs Effectively
 
https://www.chiark.greenend.org.uk/~sgtatham/bugs.html
 
https://www.chiark.greenend.org.uk/~sgtatham/bugs.html
   −
Asking mart questions
+
Asking smart questions
 
http://www.catb.org/esr/faqs/smart-questions.html
 
http://www.catb.org/esr/faqs/smart-questions.html
   Line 18: Line 45:     
===History===
 
===History===
 +
 
Tell us about your server history - upgrades/updates and what you have installed, and then some debugging output.
 
Tell us about your server history - upgrades/updates and what you have installed, and then some debugging output.
   Line 54: Line 82:  
  grep -iE "uninitialized|WARNING|ERROR" /var/log/*
 
  grep -iE "uninitialized|WARNING|ERROR" /var/log/*
   −
===Old how to===
+
===Opening Bugs===
 +
 
 +
General rules for bugs.
 +
 
 +
Don't just open a bug because you have a problem.
 +
 
 +
The bug tracker is for fixing errors in the code, not a general help forum. That's what the forums are for!
 +
 
 +
If you ask in the forums then a developer or more experienced user will usually advise you whether to open a bug or not.
 +
 
 +
Can repeat the issue or not?
 +
 
 +
If you can repeat it then so can developers, and if they can repeat it they can find and try and fix it.
 +
 
 +
Have a good read on the interwebs first. Koozali SME does not supply every package - many come from upstream and we can't specifically fix them. A bug has to be lodged in the right place.
 +
 
 +
Make sure you have done your homework first and prepared all the debug data. It makes it far easier to repeat and fix.
 +
 
 +
Be prepared to help the developer with a fix, and test it.
 +
 
 +
Be patient.
    
----
 
----
 
[[Category:Howto]]
 
[[Category:Howto]]

Navigation menu