📖 How to Use This Handbook

🚀 Philosophy: "Hands-On > Reading"

You cannot learn shell by reading. You must type.

1. Read the concept.
2. Open your terminal.
3. Type the example.
4. Break it. (Change variables, delete flags, see it fail).
5. Fix it.

🛠️ Recommended Setup

Component	Recommendation	Why?
OS	Linux (Ubuntu/Debian) or WSL2	Standard DevOps environment.
Shell	bash (default) or zsh + oh-my-zsh	Comfort + plugins.
Editor	VS Code + "ShellCheck" extension	Catches errors before you run them.
Notes	Obsidian or VS Code Markdown	This handbook is designed for it.

🧪 Testing Portability

To check if your script is truly POSIX-compliant:

# Run your script with 'dash' (strict POSIX shell)
dash your-script.sh

If it works in dash, it will work almost everywhere.

🔀 Navigation

• 👉 Next: Basics 101
• 👈 Back to Index