bamr87 · bamr87 · Dec 28, 2023 · Dec 11, 2023 · Dec 14, 2023 · Dec 16, 2023
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -2,3 +2,5 @@
 lastmod: '2021-10-27T17:32:59.526Z'
 ---
 This is how to contribute.
+
+Will base this on Github's documentaiton [here](https://docs.github.com/en/contributing)https://docs.github.com/en/contributing
diff --git a/README.md b/README.md
@@ -1,5 +1,52 @@
 # README
 
+Welcome to the source code reposoity for it-journey.dev.
+
+## About IT-Journey.dev
+
+IT-Journey.dev is a collaborative platform dedicated to the world of Information Technology (IT). Our mission is to provide a comprehensive resource for IT professionals, students, and enthusiasts to learn, share, and grow in the dynamic field of IT.
+
+## What You'll Find Here
+
+- **Tutorials & Guides:** Step-by-step tutorials and guides covering various IT topics, from basic programming to advanced network security.
+- **Community Articles:** Contributions from members of the IT community, offering insights, tips, and experiences.
+- **Resource Library:** A curated collection of resources like e-books, whitepapers, and tools beneficial for IT learning and development.
+- **Discussion Forums:** Engage with other IT professionals, ask questions, and share your knowledge.
+- **Career Advice:** Guidance and tips for building a successful career in IT, including interview preparation and resume building.
+
+## How to Navigate
+
+- **Homepage:** Start here to see the latest updates, featured articles, and community highlights.
+- **Tutorials Section:** Categorized tutorials for easy navigation based on your interests and skill level.
+- **Community Hub:** Access user-contributed articles and join discussions in the forums.
+- **Resources:** Explore our extensive library of IT resources.
+- **Career Center:** Get advice and tools for advancing your IT career.
+
+## Contributing to IT-Journey.dev
+
+We welcome and appreciate contributions from the IT community. Here’s how you can be part of our journey:
+
+1. **Become a Contributor:** Share your expertise by writing articles or tutorials. Visit our 'Contribute' section for guidelines and submission details.
+2. **Participate in Discussions:** Join our forums, answer questions, or start new topics to engage with the community.
+3. **Provide Feedback:** Your suggestions help us improve. Use the 'Feedback' form on our site to share your thoughts.
+4. **Share Resources:** If you have resources like tools, books, or articles beneficial to the IT community, let us know!
+
+## Join Us
+
+- **Sign Up:** Create your free account to start contributing and accessing exclusive content.
+- **Follow Us:** Stay updated with the latest from IT-Journey.dev on [Twitter/Facebook/LinkedIn].
+- **Newsletter:** Subscribe to our newsletter for weekly updates and highlights.
+
+## Contact Us
+
+For queries, support, or collaboration, contact us at [[email protected]](mailto:[email protected]).
+
+Thank you for being part of IT-Journey.dev - Your Pathway to IT Mastery!
+
+---
+
+This template provides a clear and engaging overview of the site, its contents, and how users can contribute. You can tailor it to fit the specific features and guidelines of "it-journey.dev."
+
 Branch | Build Status
 ---------|---------
 Master | [![Build Status](https://app.travis-ci.com/bamr87/it-journey.svg?branch=master)](https://app.travis-ci.com/bamr87/it-journey)
@@ -16,6 +63,8 @@ From zero to hero collection of docs, tools, scripts, and information to support
 * git
 * gh cli
 
+
+
 ## Sources
 
 * [JTD](https://just-the-docs.github.io/just-the-docs/)

diff --git a/assets/gif/windows-developer-settings.gif b/assets/gif/windows-developer-settings.gif
diff --git a/pages/_docs/2023-04-15-wsl-setup-with-vscode.md b/pages/_docs/2023-04-15-wsl-setup-with-vscode.md
@@ -27,7 +27,7 @@ Visual Studio Code, along with the WSL extension, enables you to use WSL as your
 * edit files in your Linux or mounted Windows filesystem (for example /mnt/c) without worrying about pathing issues, binary compatibility, or other cross-OS challenges
 
 ## Install VS Code and the WSL extension
-
+ 
 * Visit the [VS Code install page](https://code.visualstudio.com/download) and select the 32 or 64 bit installer. Install Visual Studio Code on Windows (not in your WSL file system).
 
 * When prompted to **Select Additional Tasks** during installation, be sure to check the **Add to PATH** option so you can easily open a folder in WSL using the code command.

diff --git a/pages/_docs/doc-index.md b/pages/_docs/doc-index.md
@@ -1,9 +1,9 @@
 ---
 title: Docs Index (~)
-author: null
+author: Amr Abdel Eissa
 layout: collection
 permalink: /docs/
-description: null
+description: Index of all doc pages and instructions on how to add new doc sections
 catagories:
   - docs
   - home
@@ -15,10 +15,24 @@ date: 2021-09-24T19:32:44.876Z
 lastmod: 2023-12-03T01:21:22.098Z
 draft: true
 ---
-These are the docs
+
+You have reached the documentation (library) section of this site, which will contain detailed information of various components of this site (e.g., jekyll, bootstrap, etc.). The ultimate goal is to house a documentation site that operates very similar to Microsoft's doc site [here](https://learn.microsoft.com/en-us/docs/).
+
+These docs are sourced using the git module function, cleaned up with some scripts, and then generated using jekyll. In the future, these docs will have multiple engines to created (i.e., using Hugo to create the docs site).
+
+Current, we have docs for the following applications:
+
+- Ruby
+- Jekyll
+- Liquid
+- Bootstrap
+- 
+
+To add to this collection, you need to run the following commands on your local development environment:
 
 ## Jekyll
 [official docs](https://jekyllrb.com/docs/)
+
 ```sh
 git submodule add https://github.com/jekyll/jekyll.git jekyll-docs
 

diff --git a/pages/_notes/index.md b/pages/_notes/index.md
@@ -264,4 +264,22 @@ https://icons.getbootstrap.com/#install
 
 <i class="bi bi-gem"></i>
 
-![](../../assets/images/penrose-hard.png)
+![](../../assets/images/penrose-hard.png)
+
+## OS Based instructions
+
+{% mac %}
+
+These instructions are pertinent to Mac users.
+
+{% endmac %}
+{% linux %}
+
+ These instructions are pertinent to Linux users.
+
+{% endlinux %}
+{% windows %}
+
+These instructions are pertinent to Windows users.
+
+{% endwindows %}
diff --git a/pages/_quickstart/win-setup.md b/pages/_quickstart/win-setup.md
@@ -19,49 +19,15 @@ These are the steps to setup this jekyll site repository on a Windows PC. All th
 - Ruby
 - Jekyll
 
-## Windows Developer Settings
+## Windows Developer Settings (Windows 10 only)
 
-![](/assets/gif/windows-developer-settings.gif))
-
-```powershell
-# Enable Developer Mode, apply File Explorer settings, and change execution policy
-
-# Check if running with elevated privileges
-if (-not ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
-    Write-Host "Please run this script as an administrator."
-
-    # Pause before exiting
-    Read-Host "Press Enter to exit..."
-    exit
-}
-
-# Enable developer mode
-Write-Host "Enabling Developer Mode..."
-reg add "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /v AllowDevelopmentWithoutDevLicense /t REG_DWORD /d 1 /f
-
-# Apply File Explorer settings
-Write-Host "Applying File Explorer settings..."
-reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" /v Hidden /t REG_DWORD /d 1 /f
-reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" /v HideFileExt /t REG_DWORD /d 0 /f
-reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" /v ShowFullPath /t REG_DWORD /d 1 /f
-reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" /v ShowEncryptCompressedColor /t REG_DWORD /d 1 /f
-reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" /v AutoCheckSelect /t REG_DWORD /d 1 /f
-
-# Change execution policy to allow local PowerShell scripts
-Write-Host "Changing execution policy..."
-Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
-
-Write-Host "Developer mode has been enabled, File Explorer settings applied, and execution policy changed."
-Write-Host "Please check the 'For developers' section in 'Update & Security' settings for confirmation."
-
-# Pause before exiting
-Read-Host "Press Enter to exit..."
-
-```
+Update your OS settings to allow shell scripts to execute and to install winget (if applicable). Without this setting, you may run into issues later on.
 
+![](/assets/gif/windows-developer-settings.gif))
 
+NOTE: This change opens up a lot of security vualnerabilities so proceed with caution. 
 
-### Install Winget
+### Install Winget (Windows 10 only)
 
 Winget is a package manager for Windows and is developed and maintained [here](https://github.com/microsoft/winget-cli).