From d8e07f4bd209cb855a7a4971b908d7a9e6d9efb4 Mon Sep 17 00:00:00 2001 From: Beecher Baker Date: Thu, 22 Aug 2024 16:59:10 -0400 Subject: [PATCH] Decribe dev setup --- README.markdown | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/README.markdown b/README.markdown index 9de5dff..2184c82 100644 --- a/README.markdown +++ b/README.markdown @@ -1,3 +1,36 @@ +# Purdue + +This is a fork by of [TaxonPages(https://github.com/speciesFileGroup/taxonpages) +to search the [Purdue Entomological Research Collection](https://ag.purdue.edu/department/entm/perc/) (PERC). + +## Developing + +There are two repos, which each have their own set of Github Pages for deployment automation: +* Production — [taxonpages](https://github.com/PurdueEntomologicalResearchCollection/taxonpages) — [published here](https://purdueentomologicalresearchcollection.github.io/taxonpages/) +* Development — [taxonpages-dev](https://github.com/PurdueEntomologicalResearchCollection/taxonpages-dev) — [published here](https://purdueentomologicalresearchcollection.github.io/taxonpages-dev/)] + +Why two repos? Because each [can only have one set of Github Pages](https://github.com/orgs/community/discussions/21582) +— and we want a way to deploy a development branch for QA. + +Our standard practice is to work on two branches +* `main` — connected to the `prod` repo's `main` branch, and deployed to the PERC search page. +* `dev` — connected to the `dev` repo's `main` branch (and the `prod` repo's `dev` branch). Deployed to the PERC test search page. + +Initial setup: + +1. Clone the production repo + 1. `git clone git@github.com:PurdueEntomologicalResearchCollection/taxonpages.git` + 2. `cd taxonpages` +2. Fetch from the `dev` repo into a local `dev` branch. + 1. `git remote add dev git@github.com:PurdueEntomologicalResearchCollection/taxonpages-dev.git` + 2. `git pull remote main:dev` + +Making changes: +1. Push changes to `dev` (they will deploy automatically) + 1. TODO add details +2. Merge up to `prod` (they will deploy automatically) + 1. TODO add details + # TaxonPages TaxonPages is a tool to serve taxon pages. At present it draws data from TaxonWorks' API, however we seek to keep the TaxonPages platform agnostic therefor facilitating the modular addition of functionality that may reference data from any biodiversity data-serving API.