Support

Before all else, thank you for taking the time for submitting an issue, and I'm sorry that I've probably interrupted your flow.

Your report matters to me. I love hearing my software helps you, and it pains me to know that things aren't working for you. If you have any questions on the use of the plugin, please do not hesitate to file a GitHub issue to ask for help. If you're reporting a bug in the plugin, please take a moment to glance through the Support Request Guidelines; it will make sure I get your problem fixed as quick as possible. Clear bug reports commonly have time-to-fix of 10 minutes. The guidelines are very detailed, perhaps to the point of being off-putting, but please do not fret; these guidelines simply express my ideal bug submission. I of course prefer very clearly documented issue reports over fuzzy ones, but I prefer fuzzy ones over missed ones.

Known problems

• Better BibTeX will fail with incomprehensible errors if you run but Zotero Standalone and Zotero for Firefox simultaniously #143
• If Zotero stalls with BBT installed, it is often a one-time thing as the cache fills

Submitting an issue

Unfortunately, however, my time is extremely limited for a number of very great reasons (you shall have to trust me on this). Because of this, I cannot accept bug reports or support requests on anything but the latest version.

If you submit an issue report, please include the version that you are on. By the time I get to your issue, the latest version might have bumped up already, and you will have to upgrade (you might have auto-upgraded already however) and re-verify that your issue still exists. Apologies for the inconvenience, but such are the breaks.

Better BibTeX

• You can send off an error report by choosing Report Better BibTeX Errors from the gear menu. Post the resulting url in a github issue.
• You can send off an error report for a specific collection or (selection of) items that fails to export by selecting those, right-clicking and choosing Report Better BibTeX Errors

That in itself will in many cases give me what I need. Don't forget to copy the generated public ID to paste it into the github issue; you cannot call it up later (although you can just so it again). Still, if you want a faster fix:

• Please include specifics of what doesn't work. I use this plugin every day myself, so "it doesn't work" is trivially false. Please tell me what you expected and what you see happening, and the relevant difference between them.
• Please don't file a jumble of problems in one issue. Posting a slew of separate issues is much preferred, as I can more easily tackle them one by one.
• Do not hijack existing issues. You can chime in on existing issues if you're close to certain it is the same problem, otherwise, open a new issue. I rather have duplicate issues than issues I cannot close because they are in fact two or more issues.
• If your problem pertains to importing BibTeX files, you must put up a sample for me to reproduce the issue with. Do not paste the sample in the issue, as the issue tracker will format it into oblivion. Instead, choose one of these options:
  • Post an URL in the issue where I can download your sample, or
  • Put the sample in a gist and post the URL of the gist into the issue, or
  • upload your files to dbinbox -- please use descriptive file names (at least the issue number), as I can't see who uploaded what.
• If your problem pertains to BBT interfering with other plugins (which wouldn't be the first time), and this interference has something to do with importing, you must include a sample file that triggers the issue. I know it may seem that "any file triggers it" -- I need a specific file that does so I know we're looking at the same problem.