diff --git a/README.md b/README.md
index 0ce834b..7a1c031 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,7 @@
+
This is a project for you to practice contributing to open source projects with code.
diff --git a/contributors/Degrandiloquent.html b/contributors/Degrandiloquent.html
new file mode 100644
index 0000000..44aa957
--- /dev/null
+++ b/contributors/Degrandiloquent.html
@@ -0,0 +1,21 @@
+
+ Dyphe Xihluke Chauke 🇿🇦
+
+ Software Developer with a passion for building efficient and reliable systems.
+ I have a background in C++, Python, Java, and SQL, and I enjoy working on projects
+ that challenge me to learn and grow. I am particularly interested in Data Structures
+ & Algorithms and Computer Networking.
+
+
+ Programming languages I use:
+ C++
+ Python
+ Java
+ SQL
+ Data Structures & Algorithms
+ Computer Networking
+
+
+ 
+
+
\ No newline at end of file
diff --git a/contributors/MathekoTauu.html b/contributors/MathekoTauu.html
new file mode 100644
index 0000000..f52ea4e
--- /dev/null
+++ b/contributors/MathekoTauu.html
@@ -0,0 +1,48 @@
+
+
+
+
+
+ Document
+
+
+
+ Matheko Masemola
+ A software developer passionate about open source and systems programming.
+ Programming languages I use
+ Python
+ C++
+
+
+
+
+ Tools I use
+
+ 
+ 
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/contributors/cust.html b/contributors/cust.html
new file mode 100644
index 0000000..51b0c1d
--- /dev/null
+++ b/contributors/cust.html
@@ -0,0 +1,37 @@
+
+ Custóio Titosse
+ Fullstack developer, Devops and learning Bitcoin and exploring open source
+ Programming languages I use
+
+ Python
+ Java
+ TypeScript
+ Rust
+
+
+ Tools I use
+
+
+
diff --git a/contributors/omphile.html b/contributors/omphile.html
new file mode 100644
index 0000000..8861398
--- /dev/null
+++ b/contributors/omphile.html
@@ -0,0 +1,32 @@
+
+ Omphile
+ Aspiring developer,passionate about building clean,user-friendly,scalable responsive websites
+ Html / JavaScript / CSS
+
+
+ Tools I use
+
+
+
+
+
+
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
index 5a09f3b..ab2da2e 100644
--- a/docs/CONTRIBUTING.md
+++ b/docs/CONTRIBUTING.md
@@ -78,23 +78,20 @@ You can add your card as an HTML file in the contributors directory. Create a fi
```
-## Add your card to contributors list
+## View your changes in a web browser
-Add the name of the file you created to `scripts/contributors.js` file.
+You can see your changes by opening `index.html` in a web browser. To do this, first run the generate cards script to update the contributors list:
-`scripts/contributors.js`
-```js
-const contributorFiles = [
- "btrust-builders.html",
- "your-github-username.html", // add your file name here
-];
+```bash
+bash scripts/generate-cards.sh
```
-## View your changes in a web browser
+Then open `index.html` in your browser. You should be able to see the new card you added in the previous step.
-You can see your changes by opening `index.html` in a web browser. You should be able to see the new card you added in the previous steps.
+You can continue making changes to your card, re-run the script, and refresh the web browser tab to see those changes.
-You can continue making changes to your card and refresh the web browser tab to see those changes.
+> [!NOTE]
+> You don't need to commit the generated `scripts/contributors.js` file. The CI pipeline runs this script automatically when your pull request is submitted.
## Commit your changes
+ 
+ 
+ 
+ 
+