adding simple ci tutorial

Author: charlycastro

makefile

@@ -0,0 +1,21 @@
+.PHONY: help
+help: ## Display this help screen
+	@echo "Please use \`make <target>' where <target> is one of"
+	@grep -E '^[a-zA-Z_-][a-zA-Z_\-\/]+[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\t\033[36m%-30s\033[0m %s\n", $$1, $$2}'
+	@echo "make sure to populate your env with \`source bin/env' before using this tool"
+
+.PHONY: deps
+deps: ## Install dependencies
+	@echo "install  deps"
+
+.PHONY: test
+test: ## Unit test our code
+		@echo "testing code"
+
+.PHONY: build
+build: ## Builds our code 
+	@echo "building site"
+
+.PHONY: deploy
+deploy: ## Deploys our built artifact
+	@echo "deploys our built artifact"

references/yamls/gh-ci-demo.yml

@@ -0,0 +1,18 @@
+name: GitHub Actions CI
+on:
+  pull_request:
+    branches: [main]
+jobs:
+  mysite-ci:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v2
+      - name: install dependencies
+        run: make deps
+      - name: test code
+        run: make test
+      - name: build code
+        run: make build
+      - name: store artifact
+        run: echo "save artifact where you want"

references/yamls/gh-ci-reuse.yml

@@ -0,0 +1,16 @@
+name: GitHub Actions Reusable actions
+on:
+  pull_request:
+    branches: [main]
+jobs:
+  reuse-ci:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v2
+      - name: reviewdog-markdownlint
+        uses: reviewdog/[email protected]
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          reporter: github-pr-review
+          filter_mode: nofilter # file to only check new or mod files

references/yamls/pr-markdownlint-review.yml

@@ -0,0 +1,22 @@
+name: Reviewdog-Markdownlint
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  reviewdog-markdownlint:
+    name: reviewdog-markdown-linter
+    runs-on: ubuntu-latest
+    strategy:
+        matrix:
+          node-version: [10.x]  
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v2
+
+      - name: reviewdog-markdownlint
+        uses: reviewdog/[email protected]
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          reporter: github-pr-review
+          filter_mode: file

references/yamls/simple-markdownlint-check.yml

@@ -0,0 +1,30 @@
+name: Markdownlint
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  markdownlint:
+    name: markdown-linter
+    runs-on: ubuntu-latest
+    strategy:
+        matrix:
+          node-version: [10.x]  
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v2
+
+      - name: Install Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v1
+        with:
+            node-version: ${{ matrix.node-version }}
+
+      - name: Install markdownlint
+        run: |
+            npm install -g markdownlint-cli
+        continue-on-error: false
+
+      - name: Run markdownlint
+        run: |
+            markdownlint -f 'static_hugo_site/content/**/*.md'
+        continue-on-error: false

tutorials/simple-ci/traditional-ci.md

@@ -0,0 +1,74 @@
+# Traditional CI GitHub Actions
+
+## Introduction
+
+The following example shows you how GitHub Actions jobs help you setup a CI workflow
+
+## Creating your first CI workflow
+
+1. Fork this repo from  [here](https://github.com/wizelineacademy/github-actions-tutorial) or create a new repo from [here](https://github.com/new)
+
+1. Start the web editor by pressing "." in your repo `https://github.com/<yourusername>/github-actions-tutorial`
+
+1. Create a new branch
+
+1. Create a `.github/workflows` directory in  your repository in GitHub if this directory does not already exist.
+
+1. In the `.github/workflows` directory, create a file named gh-ci-demo.yml
+
+1. Copy the following YAML contents into the `gh-ci-demo.yml` file:
+
+```yaml{:copy}
+name: GitHub Actions CI
+on:
+  pull_request:
+    branches: [main]
+jobs:
+  mysite-ci:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v2
+      - name: install dependencies
+        run: make deps
+      - name: test code
+        run: make test
+      - name: build code
+        run: make build
+      - name: store artifact
+        run: echo "save artifact where you want"
+```
+
+1. Create a PR with new branch and use main as base branch
+
+1. Review Action Tab
+
+1. Lets update our makefile deps command with
+
+```bash
+deps: ## Install dependencies
+  @echo "install  deps"
+  npm install -g markdownlint-cli
+```
+
+1. Lets update our makefile test command with
+
+```bash
+.PHONY: test
+test: ## Unit test our code
+  @echo "testing code"
+  markdownlint -f 'static_hugo_site/content/**/*.md'
+```
+
+1. Review our current Open PR for failed CI
+
+1. Lets fix our fix `static_hugo_site/content/post/sample-post/index.md` line 21 and break it in 2
+
+```md
+This article offers a sample of basic Markdown syntax that can be used in Hugo content files, also it shows 
+whether basic HTML elements are decorated with CSS in a Hugo theme.
+```
+
+1. Commit file
+
+1. Review our current Open PR for Pass CI