From f0edc3968e5a044c82fef0b04d4815952d9b291b Mon Sep 17 00:00:00 2001 From: Tyler Pennebaker Date: Tue, 22 Mar 2022 21:13:02 -0700 Subject: [PATCH 1/2] DOC: Create placeholder CONTRIBUTING.md --- .github/CONTRIBUTING.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 .github/CONTRIBUTING.md diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md new file mode 100644 index 00000000..8a1b9f12 --- /dev/null +++ b/.github/CONTRIBUTING.md @@ -0,0 +1 @@ +# Contribution Guidelines From c858c6945bca78549408d4e6071565890dfa4dc6 Mon Sep 17 00:00:00 2001 From: Tyler Pennebaker Date: Tue, 22 Mar 2022 21:31:24 -0700 Subject: [PATCH 2/2] Update README.md --- README.md | 28 ++++++++++------------------ 1 file changed, 10 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 44510680..02de8679 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,18 @@ # engineering_tools -A repository of scripts, configuration useful for the PCDS team +A repository of scripts and configurations useful for the PCDS team -## Push updates -``` -git push -u origin master -``` - -## Add Tag -``` -git tag -a R{tag} -m '{comment}' - -git push -u origin R{tag} -``` +## Contribution guidelines +Before making changes to this repository, please read the [contribution guidelines](https://github.com/pcdshub/engineering_tools/blob/docs_update/.github/CONTRIBUTING.md). ## Creating a new release +Navigate to https://github.com/pcdshub/engineering_tools/releases/new and create a new tag according to [semantic versioning](https://semver.org) conventions. You can use this same tag for the "Release title" or make up something more creative. For the description the "Auto-generate release notes" button works quite well but feel free to add additional comments at the top if you feel so inclined. Click the green button to publish the release then proceed to deploy this release on the LCLS servers: ``` -# Clone the source code into a new folder -git clone https://github.com/pcdshub/engineering_tools.git R{tag} -# Enter repository -cd R{Tag} -# checkout tag number -git checkout tags/R{tag} +# Navigate to the main engineering_tools directory +cd /cds/group/pcds/engineering_tools +# Deploy using the pkg_release script +pkg_release engineering_tools R{tag} +# Repoint the latest-released link to your new release +ln -nsf R{tag} latest-released ``` ## Updating latest