Merge 'origin/dev/14.5.0' into bugfix/alk4-chem-brewer2023

Resolved conflicts in:
	CHANGELOG.md
	KPP/fullchem/fullchem.eqn
	KPP/fullchem/fullchem.kpp
	run/shared/species_database.yml

Signed-off-by: Melissa Sulprizio <mpayer@seas.harvard.edu>

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,136 @@
+name: Bug or Issue Report
+description: Report a bug or issue with GEOS-Chem
+title: "Put a one-line description here"
+labels: ["category: Bug"]
+body:
+ - type: input
+ id: name
+ attributes:
+ label: Your name
+ validations:
+ required: true
+ - type: input
+ id: affiliation
+ attributes:
+ label: Your affiliation
+ validations:
+ required: true
+ - type: textarea
+ id: what-happened
+ attributes:
+ label: What happened? What did you expect to happen?
+ placeholder: Describe your issue
+ validations:
+ required: true
+ - type: textarea
+ id: steps-to-reproduce
+ attributes:
+ label: What are the steps to reproduce the bug?
+ placeholder: Explain what you did
+ validations:
+ required: true
+ - type: textarea
+ id: log-files
+ attributes:
+ label: Please attach any relevant configuration and log files.
+ description: Drag and drop files like the GEOS-Chem log file, geoschem_config.yml, HEMCO_Config.rc, HISTORY.rc, and build_info/summarize_build here. You may need to rename files to end in .txt first.
+ validations:
+ required: false
+ - type: input
+ id: version
+ attributes:
+ label: What GEOS-Chem version were you using?
+ placeholder: e.g. 14.4.0
+ validations:
+ required: true
+ - type: dropdown
+ id: machine
+ attributes:
+ label: What environment were you running GEOS-Chem on?
+ multiple: true
+ options:
+ - Local cluster
+ - AWS
+ - Personal computer
+ - Other (please explain below)
+ validations:
+ required: true
+ - type: input
+ id: compiler-version
+ attributes:
+ label: What compiler and version were you using?
+ placeholder: e.g. gcc 10.2.0, ifort 19.0.5.281
+ validations:
+ required: true
+ - type: dropdown
+ id: implemenation
+ attributes:
+ label: Will you be addressing this bug yourself?
+ description: If Yes, please also assign this issue to yourself (if possible)
+ multiple: false
+ options:
+ - "Yes"
+ - "Yes, but I will need some help"
+ - "No"
+ validations:
+ required: true
+ - type: dropdown
+ id: configuration
+ attributes:
+ label: In what configuration were you running GEOS-Chem?
+ description: If you are experiencing issues with GEOS-Chem in an external model, please contact that model's support. This repository is for tracking issues related to the GEOS-Chem science code base.
+ multiple: false
+ options:
+ - GCClassic
+ - GCHP
+ - Other (please explain in additional information section below)
+ validations:
+ required: true
+ - type: dropdown
+ id: simulation
+ attributes:
+ label: What simulation were you running?
+ description: If using full chemistry, specify extra options like benchmark, complexSOA, etc. in the additional information section below
+ multiple: false
+ options:
+ - Full chemistry
+ - Aerosol
+ - Carbon 
+ - Hg
+ - POPs
+ - TagO3
+ - TransportTracers
+ - Trace metals
+ - CH4
+ - CO2
+ - TagCO
+ validations:
+ required: true
+ - type: input
+ id: resolution
+ attributes:
+ label: As what resolution were you running GEOS-Chem?
+ description: If running a nested grid simulation, please also specify the region.
+ placeholder: "e.g. 4x5, 2x2.5, 0.25x0.3125 NA, c48, c180"
+ validations:
+ required: true
+ - type: dropdown
+ id: meteorology
+ attributes:
+ label: What meterology fields did you use?
+ multiple: false
+ options:
+ - GEOS-FP
+ - GEOS-IT
+ - MERRA-2
+ - GCAP 2.0
+ - Other (please explain in additional information section below)
+ validations:
+ required: true
+ - type: textarea
+ id: additional-info
+ attributes:
+ label: Additional information
+ description: Please provide any additional information here that you think might be relevant.
+ validations:
+ required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+ - name: GEOS-Chem user manual
+ url: https://geos-chem.readthedocs.io/en/stable
+ about: Click this link to read the GEOS-Chem user manual.

.github/ISSUE_TEMPLATE/new-feature.yml

@@ -0,0 +1,50 @@
+name: Feature Request
+description: Request a new GEOS-Chem feature
+title: "Put a one-line description here"
+labels: ["category: Feature Request"]
+body:
+ - type: input
+ id: name
+ attributes:
+ label: Your name
+ validations:
+ required: true
+ - type: input
+ id: affiliation
+ attributes:
+ label: Your affiliation
+ validations:
+ required: true
+ - type: textarea
+ id: feature-description
+ attributes:
+ label: Provide a clear and concise overview of the new feature requested.
+ validations:
+ required: true
+ - type: textarea
+ id: reference
+ attributes:
+ label: Reference(s)
+ description: If this is a science update, please provide a literature citation.
+ placeholder: "e.g. Bey et al., Global modeling of tropospheric chemistry with assimilated meteorology: Model description and evaluation, J. Geophys. Res., 106, 23,073-23,096, 2001."
+ validations:
+ required: false
+ - type: dropdown
+ id: implemenation
+ attributes:
+ label: Will you be implementing this feature yourself?
+ description: If Yes, please also assign this issue to yourself (if possible)
+ multiple: false
+ options:
+ - "Yes"
+ - "Yes, but I will need some help"
+ - "No"
+ validations:
+ required: true
+ - type: textarea
+ id: additional-info
+ attributes:
+ label: Additional information
+ description: Please provide any additional information here that you think might be relevant.
+ validations:
+ required: false

.github/ISSUE_TEMPLATE/question-discussion.yml

@@ -0,0 +1,23 @@
+name: Question or Discussion
+description: Ask a question about GEOS-Chem or start a discussion
+title: "Put a one-line description here"
+labels: ["category: Question"]
+body:
+ - type: input
+ id: name
+ attributes:
+ label: Your name
+ validations:
+ required: true
+ - type: input
+ id: affiliation
+ attributes:
+ label: Your affiliation
+ validations:
+ required: true
+ - type: textarea
+ id: description
+ attributes:
+ label: Please provide a clear and concise description of your question or discussion topic.
+ validations:
+ required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,20 @@
+### Name and Institution (Required)
+
+Name:
+Institution:
+
+### Describe the update
+
+Please provide a clear and concise overview of the update.
+
+### Expected changes
+
+Please provide details on how this update will impact model output and include plots or tables as needed.
+
+### Reference(s)
+
+If this is a science update, please provide a literature citation.
+
+### Related Github Issue
+
+Please link to the corresponding Github issue(s) here. If fixing a bug, there should be an issue describing it with steps to reproduce.