topic: using common template for gitlab | groovy | helm | jenkins (#481)

topics/gitlabci/README.md

@@ -1,23 +1,56 @@
-# Gitlab CI getting started
+## What is Gitlab CI?
 
-- https://docs.gitlab.com/ee/ci/
+### Overview
 
-# Create and run your first GitLab CI/CD pipeline
+GitLab CI/CD is a software development tool that allows organizations to implement “continuous” methodologies, including continuous integration (CI), continuous delivery (CD), and continuous deployment (also abbreviated to CD).
 
-- https://docs.gitlab.com/ee/ci/quick_start/
+### Gitlab CI workflow
 
-# Gitlab public
+- None
 
-- https://gitlab.com/
+### Official website documentation of Gitlab CI
 
-# Gitlab self deployment
+- https://docs.gitlab.com/ (CI/CD page)
 
-- https://docs.gitlab.com/ee/install/install_methods.html  
+## Prerequisites
 
-# GitLab CI/CD examples  
+- Basic linux command line skill, CICD, YAML
 
-- https://docs.gitlab.com/ee/ci/examples/ 
+## Installation
 
-# Advanced
-## Using GitLab CI/CD with a GitHub repository 
-- https://docs.gitlab.com/ee/ci/ci_cd_for_external_repos/github_integration.html
+### How to install Gitlab CI?
+
+#### Gitlab public
+
+- Use https://gitlab.com/ (No need to install)
+
+#### Gitlab self deployment
+
+- https://docs.gitlab.com/ee/install/install_methods.html
+
+##### Basics of Gitlab CI
+
+### Getting started with Gitlab CI
+
+- Visit https://docs.gitlab.com/ee/ci/quick_start/ for a comprehensive introduction.
+
+### Gitlab CI Hello World
+
+- Check the [basic/](./basic/) directory to create a simple Gitlab CI demo.
+
+## Beyond the Basics
+
+### Hands-On Example
+
+- Explore a practical hands-on example in the [Gitlab CI examples](https://docs.gitlab.com/ee/ci/examples/) for more Gitlab CI concepts
+- Check the [advanced/](./advanced//) for more Gitlab CI concepts
+
+## More...
+
+### Gitlab CI YAML syntax reference
+
+- https://docs.gitlab.com/ee/ci/yaml/
+
+### Recommended Books
+
+- None

topics/gitlabci/advanced/REAME.md

@@ -0,0 +1,3 @@
+## Using GitLab CI/CD with a GitHub repository
+
+- https://docs.gitlab.com/ee/ci/ci_cd_for_external_repos/github_integration.html

topics/groovy/README.md

@@ -1,9 +1,47 @@
-# Why groovy?
+## What is Groovy?
+
+### Overview
+
+- Groovy is a powerful, optionally typed and dynamic language, with static-typing and static compilation capabilities, for the Java platform aimed at improving developer productivity thanks to a concise, familiar and easy to learn .
 - Groovy is being used for developing the Jenkins pipeline, so it better if we have the knowledge about this language
 
-# Install groovy
+### Groovy workflow
+
+- None
+
+### Official website documentation of Groovy
+
+- https://groovy-lang.org/documentation.html
+
+## Prerequisites
+
+- None
+
+## Installation
+
+### How to install Groovy?
+
 - See https://groovy-lang.org/install.html (I prefer using SDK man)
 - Facing missing java issue while installing: Visit: [groovy-with-sdk-missing-java.md](.././../troubleshooting/installation/groovy-with-sdk-missing-java.md)
 
-# Basic groovy scripting
-- See [helloworld](./helloworld/)
+## Basics of Groovy
+
+### Groovy Hello World
+
+- Check the [basic/](./basic/) directory to create a simple Groovy demo.
+
+## Beyond the Basics
+
+### Hands-On Example
+
+- TODO
+
+## More...
+
+### Groovy extra resources
+
+- TODO
+
+### Recommended Books
+
+- TODO

topics/helm/README.md

@@ -1,6 +1,49 @@
-# How to install Helm
+## What is Helm?
+
+### Overview
+
+- Helm is the package manager for Kubernetes
+
+### Helm workflow
+
+- None
+
+### Official website documentation of Helm
+
+- https://helm.sh/docs/
+
+## Prerequisites
+
+- K8s, docker, linux
+
+## Installation
+
+### How to install Helm?
+
 - https://helm.sh/docs/intro/install/
-# Helm quick start guide
+
+## Basics of Helm
+
+### Helm quick start
+
 - https://helm.sh/docs/intro/quickstart/
-# Helm cheatsheet
+
+### Helm Hello World
+
+- Check the [basic/](./basic/) directory to create a simple Helm demo.
+
+## Beyond the Basics
+
+### Hands-On Example
+
+- Check the [advanced/](./advanced/) directory for more Helm examples.
+
+## More...
+
+### Helm cheatsheet
+
 - https://helm.sh/docs/intro/cheatsheet/
+
+### Recommended Books
+
+- TODO

topics/jenkins/README.md

@@ -1,11 +1,53 @@
-# How to install Jenkins
+## What is Jenkins?
+
+### Overview
+
+- The leading open source automation server, Jenkins provides hundreds of plugins to support building, deploying and automating any project.
+
+### Jenkins workflow
+
+- None
+
+### Official website documentation of Jenkins
+
+- https://www.jenkins.io/doc/
+
+## Prerequisites
+
+- K8s, docker, linux
+
+## Installation
+
+### How to install Jenkins?
+
 - https://www.jenkins.io/doc/book/installing/
 
-# Learn Jenkins Basics
+### Install Jenkins with Docker
+
+- See [deploy-jenkins/README.md](../Jenkins/basic/deploy-jenkins/README.md)
+
+## Basics of Jenkins
+
+### Jenkins getting started
+
 - https://www.jenkins.io/doc/book/pipeline/getting-started/
 
-# Install Jenkins with Helm
-- See [deploy-jenkins/README.md](../helm/hands-on/deploy-jenkins/README.md)
+### Jenkins Hello World
+
+- See: [Jenkins Hello world](./basic/Jenkins-Hello-World.md)
+
+## Beyond the Basics
+
+### Hands-On Example
+
+- Check the [advanced/](./advanced/) directory for more Jenkins examples.
+
+## More...
+
+### Jenkins cheatsheet
+
+- None
+
+### Recommended Books
 
-# Jenkins Helloworld Hands on
-- See: [Jenkins Hello world](./helloworld/Jenkins-Hello-World.md)
+- None

topics/jenkins/advanced/README.md

@@ -0,0 +1 @@
+# TODO