From cbb5081e0073794fcafee0794902cd155677f01b Mon Sep 17 00:00:00 2001 From: soxhi8 Date: Sun, 5 Jan 2020 03:09:31 +0100 Subject: [PATCH 1/3] Add README.md Initial touch --- README.md | 2 ++ 1 file changed, 2 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 00000000..7ab50712 --- /dev/null +++ b/README.md @@ -0,0 +1,2 @@ +# cicm_web +Canary Islands Computer Museum Website From a37ba02b70988231d57399790bade81f03747a71 Mon Sep 17 00:00:00 2001 From: Natalia Portillo Date: Thu, 9 Jan 2020 21:38:37 +0000 Subject: [PATCH 2/3] Add some text to README. --- README.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 7ab50712..9fb33b19 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,7 @@ -# cicm_web -Canary Islands Computer Museum Website +# Canary Islands Computer Museum Website + +Welcome to the Canary Islands Computer Museum Website repository. + +This repository contains the CICM Website software. + +For contributing please read [here.](CONTRIBUTING.md) From f34a619f1f21bb798c3e29959ae2dcbffae96d3d Mon Sep 17 00:00:00 2001 From: Natalia Portillo Date: Thu, 9 Jan 2020 22:43:03 +0000 Subject: [PATCH 3/3] Add guide to configure commit signing on Windows. --- CONTRIBUTING.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 00000000..298ad158 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,36 @@ +# Contributing + +## Commit signature +For security reason we require all commits to be cryptographically signed. +This section explains how to setup the development environment for that purpose. + +### Visual Studio and Visual Studio Code for Windows +You need to install Git for Windows. It is available as a component of Visual Studio, or separately in https://gitforwindows.org. + +You also need to install Gpg4win from https://www.gpg4win.org. Ensure to select the Kleopatra component. + +Once you have them installed, open Kleopatra and generate a new key pair, of OpenPGP type, following the instructions [here](https://www.gpg4win.org/doc/en/gpg4win-compendium_12.html). +Save aside the fingerprint, you'll need it later. + +Now go to environment variables (in the properties of your computer) and add this to the path: +`C:\Program Files\Git\usr\bin` + +Finally, open Git Bash, and write the following commands if you want all git commits to be signed: +```bash +git config --global commit.gpgsign true +git config --global user.signingkey +git config --global gpg.program "C:\Program Files (x86)\GnuPG\bin\gpg.exe" +``` +or if you want the options to apply only for this project +```bash +cd /DRIVE/PATH_TO_PROJECT +git config commit.gpgsign true +git config user.signingkey FINGERPRINT +git config gpg.program "C:\Program Files (x86)\GnuPG\bin\gpg.exe" +``` + +replacing `FINGERPRINT` with the fingerprint you saved from the key generation, `DRIVE` with the drive letter and `PATH_TO_PROJECT` using `/` as path separator. + +Once this is done, every time you commit in VS / VSCode, a message box titled `pinentry-qt` will ask for the passphrase you set up earlier and sign the commit with your key. + +For GitHub to recognize your signature you need to follow the steps [here](https://help.github.com/en/github/authenticating-to-github/adding-a-new-gpg-key-to-your-github-account). \ No newline at end of file