Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
reporting_problems [2018/10/20 00:00] dstillmanreporting_problems [2020/09/01 13:47] – [Reporting Zotero Problems] Fix typo dstillman
Line 1: Line 1:
 ====== Reporting Zotero Problems ====== ====== Reporting Zotero Problems ======
  
-Is something in Zotero not working correctly for you? Here'how you can provide feedback that will allow others to help you most effectively.+Is something in Zotero not working correctly for you? Here'the information you'll need to provide in the [[/forum|Zotero Forums]] to allow Zotero developers and others to help you most effectively.
  
 ** Please provide both #1 and #2 listed below. ** ** Please provide both #1 and #2 listed below. **
Line 11: Line 11:
 If you're experiencing a problem, before restarting Zotero, open the Help menu in Zotero and select "Report Errors…". If you're experiencing a problem, before restarting Zotero, open the Help menu in Zotero and select "Report Errors…".
  
-In the window that pops up, submit the error report, and then copy the Report ID (not the contents of the report) and paste it into your Zotero Forums thread. Error reports aren't reviewed unless referred to in the forums, since the reports generally aren't helpful without context and/or follow-up.+In the window that pops up, submit the error report, and then copy the numeric Report ID (not the contents of the report) and paste it into your Zotero Forums thread. Error reports aren't reviewed unless referred to in the forums, since the reports generally aren't helpful without context and/or follow-up.
  
 If you're not able to provide a Report ID, be sure to include your operating system and [[kb:zotero version|Zotero version]] in your forum post. If you're not able to provide a Report ID, be sure to include your operating system and [[kb:zotero version|Zotero version]] in your forum post.
  
-=== Zotero Connectors === +=== Zotero Connector === 
-If you're experiencing a problem, before restarting the browser, open the Zotero Connector preferences:+ 
 +If you're experiencing a problem with the Zotero Connector, before restarting the browser, open the Zotero Connector preferences: 
   * **Chrome:** Right-click on the "Save to Zotero" button and click Preferences, or type %%chrome://extensions%% into the address bar, press Enter, click "Details" under Zotero Connector, and then click "Extension options".   * **Chrome:** Right-click on the "Save to Zotero" button and click Preferences, or type %%chrome://extensions%% into the address bar, press Enter, click "Details" under Zotero Connector, and then click "Extension options".
   * **Safari:** Right-click anywhere on a webpage and select "Zotero Preferences..."   * **Safari:** Right-click anywhere on a webpage and select "Zotero Preferences..."
Line 27: Line 29:
 ==== 2. Provide Steps to Reproduce ==== ==== 2. Provide Steps to Reproduce ====
  
-The most important thing you can do to help us fix a problem is to explain exactly what's happening and how to consistently reproduce it: if you can, we can almost certainly fix it quickly or tell you how to fix it. Note that after a problem occurs, other things in Zotero may temporarily break, so it's important to restart Zotero and try to repeat what you did before it occurred.+The best way to help us fix a problem is to explain exactly what's happening and how to consistently reproduce it: if you can, there's a very good chance we can fix it quickly or tell you how to fix it. Note that after a problem occurs, other things in Zotero may temporarily break, so it's important to restart Zotero and try to repeat what you did before it occurred.
  
-Post a message to the forums with the follow info:+If you're not able to reproduce the problem, explain what happened and what you were doing when it occurred.
  
-  - The exact steps you took to reproduce the problem (or, if you're unable to, what you were doing when the problem first occurred), including, in order, any buttons or other interface elements that you clicked on+Post a message to the forums with the following info: 
 + 
 +  - The exact steps you took to reproduce the problem — or, if you're unable to, what you were doing when the problem occurred — including any buttons or other interface elements that you clicked on
   - What happened, including **include exact error messages** or other relevant text that you see on the screen   - What happened, including **include exact error messages** or other relevant text that you see on the screen
   - What you expected to happen (unless you're reporting a clear error message)   - What you expected to happen (unless you're reporting a clear error message)
Line 52: Line 56:
 >4. Drag an item to another collection. >4. Drag an item to another collection.
 > >
->Zotero displays the message 'An error has occurred. Please restart Zotero.in the middle pane.+>Zotero displays the message "An error has occurred. Please restart Zotero.in the middle pane.
  
 === Bad: === === Bad: ===
Line 105: Line 109:
 === Alternative: Error Console === === Alternative: Error Console ===
  
-If the above steps don't work, repeat the steps above, replacing "-ZoteroDebug" with "-jsconsole". Zotero should open with a separate Error Console window showing errors that have occurred. Right-click on any lines with a pink background, select Copy, and paste them into your forums post.+If the above steps don't work, repeat the steps above, try replacing "-ZoteroDebug" with "-jsconsole". Zotero should open with a separate Error Console window showing errors that have occurred. Right-click on any lines with a pink background, select Copy, and paste them into your forums post. 
 + 
 +=== Alternative: Logging to the Terminal ===
  
 +If Zotero is crashing, such that the debug window opened by ''-ZoteroDebug'' closes as well, you can [[debug_output#logging_to_a_terminal_window|log to a terminal window]] instead. Upload the debug output somewhere and provide a link in your forums thread or email the output to support@zotero.org with a link to your forums thread.
reporting_problems.txt · Last modified: 2024/03/29 04:29 by dstillman