update README

Author: dpatanin

README.md

@@ -1,9 +1,26 @@
 # LandingPage secureCodeBox
 
-This repository sources the [secureCodeBox landing page][prod-website].
+This repository sources the [securecodebox.io] Website. Our Webpage is meant to provide an extensive documentation about our [secureCodeBox] and many helpful guides on how to start and operate it. The Website is build with the [GatsbyJS] Framework and hosted through [GitHub Pages]. All important decision about this website are documented in our `/adr` folder. If you want to contribute to our Website, please follow the Style Guide down below.
 
 ## Build and Run
 
+In order to build and run this website you need to install [Node.js and NPM] for your platform.  
+If installed run 
+
+```
+npm install -g gatsby-cli 
+```
+
+to install the required Gatsby CLI.  
+Finally you download/clone this repository and install all required Node modules:
+
+```bash
+git clone https://github.com/secureCodeBox/securecodebox.github.io.git
+cd securecodebox.github.io
+npm install
+```
+Done! :) Now you can start developing and contributing.  
+
 For development: 
 ```bash
 gatsby develop
@@ -57,3 +74,10 @@ Icons should be license free and as close too the other icons' style as possible
 -   [iconmonstr](https://iconmonstr.com/) 
 -   [pixabay](https://pixabay.com/)
 
+
+
+[securecodebox.io]: https://securecodebox.github.io
+[secureCodeBox]: https://github.com/secureCodeBox/secureCodeBox
+[GatsbyJS]: https://www.gatsbyjs.org/
+[GitHub Pages]: https://pages.github.com/
+[Node.js and NPM]: https://nodejs.org/en/download/

adr/adr_0001.adoc

@@ -39,7 +39,7 @@ https://jekyllrb.com/[Jekyll]
 === Research
 
 These frameworks do all fulfill the requirements to the extent that I estimate them as wellsuited. First, I researched the listed features on the respective sites or quickly googled after it
-specifically and found instantly the requested feature. I followed up with in general overview
+specifically and found instantly the requested feature. I followed up with a general overview
 of how old the frameworks, how popular they are and for example pages build with them.
 Afterwards I searched for comparison blogs and posts, mostly to examine their comments.
 Most of these „pro-cons “-posts are inaccurate and very superficial, but luckily because of that
@@ -69,7 +69,7 @@ other framework we considered mainly) is based on Golang, and as for my part as
 feel completely comfortable and prefer working with JSX. Overall it comes down to preferences mostly, since we’re not going to build a giant Website, nor are we planning on implementing “crazy” Features. 
 
 == Consequences
-a
+
 For the integration of our multi-repository documentation we’ll use
 Antora if working this out with Gatsby is going to be more difficult than integrating Antora.
 We’re aware that using Gatsby requires a bit more maintenance and has the drawback, that if