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
reporting_problems [2022/09/15 18:23] – [2. Provide Steps to Reproduce] dstillmanreporting_problems [2025/03/04 03:07] (current) – [Reporting Startup Errors] dstillman
Line 14: Line 14:
  
 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.
 +
 +**Alternative:** If you're reporting a reproducible problem with a particular operation, a [[debug_output|Debug ID]], which logs activity over a specific period of time, may be more useful than a Report ID. It's always fine to provide a Debug ID instead of a Report ID if you think it might be helpful, but you can also wait for a Zotero developer to request one.
  
 === Zotero Connector === === Zotero Connector ===
Line 19: Line 21:
 If you're experiencing a problem with the Zotero Connector, 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/Options, 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..."
   * **Firefox:** Type about:addons into the address bar, press return, and click the “Preferences” button next to the entry for “Zotero Connector”. Click on the "Advanced" Tab.   * **Firefox:** Type about:addons into the address bar, press return, and click the “Preferences” button next to the entry for “Zotero Connector”. Click on the "Advanced" Tab.
Line 29: Line 31:
 === Zotero for iOS === === Zotero for iOS ===
  
-Providing a Report ID isn't currently possible on iOS.+Generating a Report ID manually isn't possible on iOS, but you can provide a [[debug_output#zotero_for_ios|Debug ID]] for a specific action. The app may also automatically provide a Report ID if a crash occurs.
 ==== 2. Provide Steps to Reproduce ==== ==== 2. Provide Steps to Reproduce ====
  
-In addition to your Report ID, you'll need to explain exactly what's happening and, ideally, 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. +In addition to your Report ID, you'll need to explain exactly what's happening and, ideally, 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. If you're not able to reproduce the problem, explain what happened and what you were doing when it occurred.
- +
-If you're not able to reproduce the problem, explain what happened and what you were doing when it occurred.+
  
 Post a message to the forums with the following info: 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+  - The exact steps you took to reproduce the problem, including specific URLs or files you accessed, any text you entered, buttons or other interface elements that you clicked on, etc.
   - What happened, including **exact error messages** or other relevant text that you see on the screen   - What happened, including **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)
 +
 +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.
  
 === Bad: === === Bad: ===
  
->Report ID: 1892199645+>I can't add unfiled items to a collection after selecting a tag. Does anyone know how to fix this?
  
 === Good: === === Good: ===
Line 58: Line 60:
 >3. With the new item selected, add the tag "Foo" from the Tags tab in the right-hand pane. >3. With the new item selected, add the tag "Foo" from the Tags tab in the right-hand pane.
 >4. Click on "Unfiled Items" in the left pane. >4. Click on "Unfiled Items" in the left pane.
->5. Click on "foo" in the tag selector.+>5. Click on "Foo" in the tag selector.
 >6. Drag the item from the middle pane to another collection. >6. Drag the item from the middle pane to another collection.
 > >
Line 93: Line 95:
  
     - Open Terminal via Spotlight or from /Applications/Utilities.     - Open Terminal via Spotlight or from /Applications/Utilities.
-    - Go to the Terminal menu and open Preferences. In Settings->Window, make sure Scrollback is set to "Limit to available memory". +    - In the terminal window that opens, paste the following and press Return. <code>/Applications/Zotero.app/Contents/MacOS/zotero -ZoteroDebug</code> 
-    - Paste the following into the terminal and hit return. <code>/Applications/Zotero.app/Contents/MacOS/zotero -ZoteroDebug</code>+ 
 +If you can't select the logging window, you can press Cmd-` (backtick, above Tab) to cycle between windows until it's selected.
  
 == Windows == == Windows ==
  
     - Press Windows-R or search for "run" to open the Run dialog.     - Press Windows-R or search for "run" to open the Run dialog.
-    - Click Browse and locate the Zotero application directory. This is typically %%"%%C:\Program Files (x86)\Zotero\%%"%%.+    - Click Browse and locate the Zotero application directory. This is typically %%"%%C:\Program Files\Zotero\%%"%%.
     - Select the %%"%%zotero.exe%%"%% file and click Open.     - Select the %%"%%zotero.exe%%"%% file and click Open.
-    - The complete path to the %%"%%zotero.exe%%"%% file will be displayed in the text box. Add %%"%% -ZoteroDebug%%"%% to the end, after any closing quotes, with a space before the hyphen. For example: <code>"C:\Program Files (x86)\Zotero\zotero.exe" -ZoteroDebug</code>+    - The complete path to the %%"%%zotero.exe%%"%% file will be displayed in the text box. Add %%"%% -ZoteroDebug%%"%% to the end, after any closing quotes, with a space before the hyphen. For example: <code>"C:\Program Files\Zotero\zotero.exe" -ZoteroDebug</code>
     - Click OK.     - Click OK.
  
reporting_problems.1663280604.txt.gz · Last modified: 2022/09/15 18:23 by dstillman