address reviews

Signed-off-by: prashant-gurung899 <prasantgrg777@gmail.com>

Author: prashant-gurung899

src/assets/woodpeckerCI/woodpeckerCI.md

@@ -4,14 +4,14 @@ authorName: Prashant Gurung
 authorAvatar: https://avatars.githubusercontent.com/u/53248463?v=4
 authorLink: https://github.com/prashant-gurung899
 createdAt: July 3, 2025
-tags: CI/CD
+tags: CI/CD, Woodpecker, starlark, docker-compose, Traefik, WCCS
 banner: https://raw.githubusercontent.com/JankariTech/blog/woodpecker-ci-starlark/src/assets/woodpeckerCI/images/cover.png
 ---
 
 ## Background
-Continuous Integration (CI) tools are vital for automating the testing and deployment of modern software. One such open-source tool is Woodpecker CI, a lightweight CI/CD system. Woodpecker CI is an open-source continuous integration and delivery platform that helps developers automate building, testing, and deploying their code. It is a community-driven fork and successor of the popular Drone CI project, sharing many design principles and compatibility with Drone pipelines. Traditionally, Woodpecker pipelines are written in YAML. But with the rise of programmable pipelines, we now have the flexibility to define our CI configuration using Starlark — a Python-like configuration language.
+Continuous Integration tools are essential to build and test modern software automatically and regularly. Woodpecker CI is one such open-source tool, a lightweight CI/CD system. Woodpecker CI is an open-source continuous integration and delivery system that help developers in automating deployment, builds, and testing of code. It's an open-source fork and alternative to the popular Drone CI project with numerous design similarities and Drone pipeline compatibility. Traditionally, Woodpecker pipelines are YAML, but now that programmable pipelines are in vogue, we can finally have the liberty of defining our CI configuration through Starlark — a Python-ish config language.
 
-In this blog, I’ll walk you through setting up Woodpecker CI with Traefik as a reverse proxy and integrating it with WCCS (Woodpecker CI Config Service) to convert Starlark configurations into YAML files, enabling us to write pipelines in .woodpecker.star files. Here's a high-level view of what we'll cover:
+In this article, I will walk you through setting up Woodpecker CI with Traefik as a reverse proxy and WCCS (Woodpecker CI Config Service) to convert Starlark configurations into YAML files so that we can write pipelines in .woodpecker.star files. Here is a high-level overview of what we are going through:
 
 - Spinning up a Woodpecker server with Traefik
 
@@ -24,12 +24,14 @@ In this blog, I’ll walk you through setting up Woodpecker CI with Traefik as a
 By the end, you’ll be able to write CI pipelines in Starlark and dynamically convert them to YAML during runtime.
 
 ## Prepare Woodpecker secrets via .env
+Create a `.env` file to store your environment variables.
+
 ```console
 #Your woodpecker host
 WOODPECKER_HOST=https://<your-ci-server>
 
 
-# GitHub OAuth Secrets
+# GitHub OAuth app Secrets - We'll create OAuth app later
 WOODPECKER_GITHUB_CLIENT=XXXXXXXXXXXXXXXX
 WOODPECKER_GITHUB_SECRET=XXXXXXXXXXXXXXXXXXXXXXXX
 
@@ -38,12 +40,13 @@ WOODPECKER_GITHUB_SECRET=XXXXXXXXXXXXXXXXXXXXXXXX
 WOODPECKER_AGENT_SECRET=<generated-secret>
 
 
-# Let’s Encrypt contact email (Traefik will use this)
+# letsEncrypt contact email (Traefik will use this)
 ACME_EMAIL=admin@example.com
 ```
 
 ## Traefik Configuration
-Traefik plays a crucial role in this architecture by handling all the networking complexities - SSL termination, routing, and load balancing
+Traefik plays a crucial role in this architecture by handling all the networking complexities - SSL termination, routing, and load balancing.
+Create a `docker-compose.yml` file and add the following Traefik service configuration:
 
 ```yml
 version: "3.9"
@@ -75,12 +78,12 @@ services:
 This configuration:
 
 - Sets up Traefik to listen on ports 80 and 443
-- Configures Let's Encrypt for automatic SSL certificate management
+- Configures automatic SSL certificate management via [letsEncrypt](https://letsencrypt.org/)
 - Enables Docker provider to automatically detect new services
 - Mounts necessary volumes for certificate storage and Docker socket access
 
 ## Setting Up Woodpecker Server and Agent
-Now that we have Traefik running, let's set up the Woodpecker server and agent services. Here's the essential setup:
+Now that we have Traefik running, let's set up the Woodpecker server and agent services in the same `docker-compose.yml` file:
 
 ```yml
   woodpecker-server:
@@ -135,7 +138,7 @@ Now that we have Traefik running, let's set up the Woodpecker server and agent s
 
 To connect GitHub with Woodpecker:
 
-1. Register a new OAuth application in your GitHub developer settings.
+1. Register a new OAuth application in your GitHub developer [settings](https://github.com/settings/applications/new).
 
 2. Set the callback URL to `https://<your-ci-server>/authorize`
 
@@ -163,7 +166,7 @@ Woodpecker will automatically add the necessary webhooks to the repo.
 
 After enabling your desired repository, there's one more thing that you need to do i.e. to set pipeline config path.
 
-- From the settings of your Woodpecker Server, go to repositories and click on the enabled repo's settings icon as shown below:
+- From the settings of your Woodpecker server, go to `Repositories` and click on the enabled repo's settings icon as shown below:
 
 ![Settings](https://raw.githubusercontent.com/JankariTech/blog/woodpecker-ci-starlark/src/assets/woodpeckerCI/images/settings.png)
 
@@ -181,6 +184,7 @@ Store that public key into `keys/public.pem` in the same directory level as your
 ## Setting Up WCCS-Woodpecker CI Config Service (Starlark Conversion Service)
 The Woodpecker Config Conversion Service (WCCS) is a lightweight web service created and maintained by [Opencloud-eu](https://opencloud.eu/en). It enables Woodpecker CI to convert pipeline definitions written in Starlark into standard YAML on the fly by receiving a signed POST request from Woodpecker.
 You can easily deploy WCCS using their official Docker image available on Docker Hub: [opencloudeu/wccs](https://hub.docker.com/r/opencloudeu/wccs).
+Update your `docker-compose.yml` to include the WCCS service:
 ```yml
   wccs:
     image: opencloudeu/wccs:latest
@@ -241,7 +245,7 @@ def main(ctx):
 
 ## Triggering Your First CI Run
 Now that you have your `.woodpecker.star` file ready, commit and push it to your GitHub repository and then, open a Pull Request from your branch <your-branch-name> to master.
-Once the PR is created, Woodpecker will automatically send the build request to WCCS, fetch the pipeline config, and start your first CI run. You can head over to the Woodpecker UI to watch the build logs in real time.
+Once the PR is created, Woodpecker will automatically send the build request to WCCS, fetch the pipeline configuration, and start your first CI run. You can head over to the Woodpecker UI to watch the build logs in real time.
 
 ![Converted Yaml](https://raw.githubusercontent.com/JankariTech/blog/woodpecker-ci-starlark/src/assets/woodpeckerCI/images/converted.png)