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
dev:source_code [2017/12/13 03:39] – [Working with Git Repositories] dstillmandev:source_code [2019/08/29 06:49] – [Working with the Zotero Source Code] dstillman
Line 13: Line 13:
  
 Zotero source code is hosted [[https://github.com/zotero|on GitHub]]. Zotero source code is hosted [[https://github.com/zotero|on GitHub]].
- 
-== Branches and Tags == 
- 
-Zotero's Git repositories often have multiple branches for different lines of development. The default branch, ''master'', is the main development branch where development is most active and where most new features are first introduced. Because of this, ''master'' code may be less stable and may be riskier for production use. Once a major version has been out for a while, a branch is created, and that branch then receives mostly bug fixes and small changes. When a release is made (e.g., Zotero 5.0.30), a snapshot of the relevant code is tagged with its version number. See Git documentation for more information on working with branches and tags. 
  
 ==== Third-Party Components ==== ==== Third-Party Components ====
Line 27: Line 23:
 ===== Issue Tracking ===== ===== Issue Tracking =====
  
-In order to keep product discussions open to as many people as possible, Zotero does not use an issue tracker for bug reports or feature requestsZotero users should use the [[/forum|Zotero Forums]] rather than GitHub to report issues and feature requests.+We don'use GitHub Issues for bug reports or feature requests regarding the Zotero client or website. Please post all such requests to the [[/forum|Zotero Forums]], where Zotero developers and many others can help. Keeping product discussions in the Zotero Forums allows the entire Zotero community to participate, including domain experts that can address many questions better than Zotero developers. See [[:zotero_support|How Zotero Support Works]] for more information.
  
-For confirmed bugs or agreed-upon changes, new issues will be created in the relevant repositories on GitHub by Zotero developers. Commit history can be viewed using the GitHub web interface or a Git client. Zotero developers previously used [[/trac|Trac]] as a source code browser and internal issue tracker, and very old tickets are still archived there.+For confirmed bugs or agreed-upon changes, Zotero developers will create new issues in the relevant repositories. 
 + 
 +Zotero developers previously used [[/trac|Trac]] as a source code browser and internal issue tracker, and very old tickets are still archived there.
 ===== Working with the Zotero Source Code ===== ===== Working with the Zotero Source Code =====
  
Line 36: Line 34:
 See [[dev/client coding/Building the Standalone Client|Building the Zotero Client]]. See [[dev/client coding/Building the Standalone Client|Building the Zotero Client]].
  
-=== Zotero Connector for Chrome ===+=== Zotero Connector ===
  
 To run a Git build of the Google Chrome Connector, you need to: To run a Git build of the Google Chrome Connector, you need to:
Line 49: Line 47:
     - Click the button "Load unpacked extension...", and give the path to the ''build/browserExt''  directory within the local repository     - Click the button "Load unpacked extension...", and give the path to the ''build/browserExt''  directory within the local repository
  
-You should now see a Zotero icon in the address bar when visiting translatable webpages (e.g., [[http://www.agu.org/journals/ABS/2002/2000JD000290.shtml|this article]] or [[http://www.amazon.com/gp/product/B002B3YBZO/ref=s9_pop_gw_ir03/190-5343882-9824666?pf_rd_m=ATVPDKIKX0DER&pf_rd_s=center-2&pf_rd_r=00JVFZE24KQ87CV9QJ59&pf_rd_t=101&pf_rd_p=1263340922&pf_rd_i=507846|this book]]), and clicking the icon should add the item to your Zotero library.+You should now see a Zotero icon in the address bar when visiting translatable webpages (e.g., [[https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2018JC014784|this article]] or [[http://www.amazon.com/gp/product/B002B3YBZO/ref=s9_pop_gw_ir03/190-5343882-9824666?pf_rd_m=ATVPDKIKX0DER&pf_rd_s=center-2&pf_rd_r=00JVFZE24KQ87CV9QJ59&pf_rd_t=101&pf_rd_p=1263340922&pf_rd_i=507846|this book]]), and clicking the icon should add the item to your Zotero library.
  
 After making changes, click Reload for the Connector entry in the Chrome Extensions pane and reload any open pages where you want to use the Connector. (If ''gulp'' isn't running, you'll need to run ''./build -d'' after each change.) After making changes, click Reload for the Connector entry in the Chrome Extensions pane and reload any open pages where you want to use the Connector. (If ''gulp'' isn't running, you'll need to run ''./build -d'' after each change.)
 +
 +See the [[https://github.com/zotero/zotero-connectors|Zotero Connector GitHub repo]] for more details.
  
 ==== Contributing patches ==== ==== Contributing patches ====
dev/source_code.txt · Last modified: 2023/05/22 04:01 by dstillman