Add documentation

Author: chaitanyarahalkar

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.github/workflows/lint.yml

@@ -0,0 +1,35 @@
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, ready_for_review, edited]
+
+jobs:
+    markdownlint:
+        runs-on: ubuntu-latest
+        container:
+          image: ghcr.io/vanilla-os/pico:main
+        steps:
+          - uses: actions/checkout@v4
+          - uses: actions/setup-node@v4
+            with:
+             node-version: '20'
+          - name: Run markdownlint
+            run: |
+              npm install -g markdownlint-cli
+              markdownlint $(find . -name '*.md' | grep -vF './.git')
+    
+    codespell:
+        runs-on: ubuntu-latest
+        container:
+          image: ghcr.io/vanilla-os/pico:main
+        steps:
+        - uses: actions/checkout@v4
+        - uses: codespell-project/actions-codespell@v2
+          with:
+             path: |
+                 articles/en
+             only_warn: 1

.gitignore

@@ -0,0 +1,5 @@
+/_site
+
+# Local Dev
+.bundle/
+vendor/

.markdownlint.yaml

@@ -0,0 +1,12 @@
+---
+MD010: false
+MD013:
+  line_length: 600
+  code_blocks: false
+  tables: false
+  headings: false
+  headers: false
+MD024: false
+MD033: false
+MD036: false
+MD041: false

CNAME

@@ -0,0 +1 @@
+documentation.vanillaos.org

LICENSE.txt

@@ -0,0 +1,12 @@
+<div align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/images/documentation.png">
+    <source media="(prefers-color-scheme: light)" srcset="assets/images/documentation-mono.png">
+    <img alt="The logo spells Documentation in cursive character." height="40" src="assets/images/documentation.png">
+  </picture>
+
+---
+
+<small>Available at <https://documentation.frostos.org>.</small>
+
+</div>

README.md

@@ -0,0 +1,54 @@
+---
+Title: অপরিবর্তনীয়তা (এবিরুট) - ভ্যানিলা ওএস
+Description: কীভাবে এবিরুট ব্যবহার করতে হয় তা শিখুন।
+Listed: true
+Authors: 
+  - Frost-OS
+---
+
+## অপরিবর্তনীয়তা (`abroot`)
+
+`abroot` এমন একটি ইউটিলিটি যা ২ টি (A⟺B) রুট বিভাজনের মাঝে অদলবদল ঘটানোর মাধ্যমে অপরিবর্তনীয়তা ও পারমাণবিকতা প্রদান করে। এছাড়াও এটি একটি অদলবদলকরণ শেলের মাধ্যমে চাহিদা-মাফিক অদলবদলের সুযোগ প্রদান করে।
+
+## যেভাবে এটি কাজ করে
+
+লিনাক্স ফাইল ব্যবস্থাপনা মূলত একটি ক্রমোচ্চ শ্রেণিবিভাগমূলক ফাইল ব্যবস্থাপনা যা রুট ও অন্যান্য ডিরেক্টরিগুলি ধারণ করে।
+রুট হচ্ছে প্রধান ক্রমোচ্চ শ্রেণিবিভাগমূলক ডিরেক্টরি যা অন্যান্য সকল ডিরেক্টরিকে ধারণ করে।
+অপরিবর্তনীয় ফাইল ব্যবস্থাপনাগুলিতে রুট বিভাজনটি রিড-ওনলি থাকে, যা গুরুত্বপূর্ণ প্যাকেজসমূহ, যেমন ড্রাইভার ইত্যাদিকে হোস্টে ইনস্টল করতে বাঁধা দেয়।
+
+`abroot` আপনাকে ফাইল ব্যবস্থাপনার অপরিবর্তনীয়তা বজায় রেখেই কার্নেল মড্যুলসমূহ, ড্রাইভারসমূহ ও অন্যান্য গুরুত্বপূর্ণ প্যাকেজগুলি ইন্সটল করার সুযোগ প্রদান করে।
+
+যখন `abroot`-এ কোনো কমান্ড রান করা হয়, তখন দ্বিতীয় রুট বিভাজনে একটি অদলবদলকরণ শেলের মাধ্যমে একটি অদলবদল প্রক্রিয়া শুরু হয়। যদি অদলবদল প্রক্রিয়াটি সফল হয়, তাহলে একটি প্রলেপ ব্যবহারের মাধ্যমে পরিবর্তনগুলি প্রয়োগ করা হয় এবং একটি রিবুটের মাধ্যমে বর্তমানে সচল বুট বিভাজনে পরিবর্তনগুলি সমন্বয়সাধন করা হয়। আর যদি অদলবদল প্রক্রিয়াটি ব্যর্থ হয়, তাহলে কোনো পরিবর্তনই প্রয়োগ করা হয় না (পারমাণবিকতা নামক একটি বৈশিষ্ট্য উপলদ্ধ থাকার দরুন)। এছাড়াও `abroot` আপনাকে `abroot shell` কমান্ড ব্যবহারের মাধ্যমে চাহিদা-মাফিক অদলবদলের সুযোগ দেয়।
+
+`abroot` এর জন্য আবশ্যক হওয়ায় ভ্যানিলা ওএস ইনস্টলেশনের সময় উভয় অবস্থার জন্য স্বতন্ত্র রুট ও বুট বিভাজন তৈরি করে (প্রতি রুট বিভাজনে 20GB করে)।
+
+## অবস্থাবলি
+
+`abroot` এর দুইটি অবস্থা রয়েছে - বর্তমান ও ভবিষ্যৎ। যখন আপনি প্রথমবারের মতো আপনার ভ্যানিলা ওএস ইনস্টলেশনে অবস্থান করেন, তখন বর্তমান অবস্থাটি থাকে A। আর যখন আপনি সিস্টেম রিবুট করেন, তখন অবস্থাটি স্বয়ংক্রিয়ভাবে B-তে পরিবর্তিত হয়ে যায়। যখন আপনি `abroot` ব্যবহার করে কোনো প্যাকেজ ইন্সটল করেন, তখন এটি ভবিষ্যৎ রুট বিভাজনে ইনস্টল হয় এবং একটি রিবুটের পর বর্তমান রুট বিভাজনের সাথে সমন্বয় সাধিত হয়।  
+
+## আপডেটসমূহ
+
+`abroot` প্রোগ্রামটি `vso` নামক একটি ইউটিলিটিকে ক্ষমতায়ন করে যা স্মার্ট স্বয়ংক্রিয় আপডেট এবং আড়ালে থেকে ভবিষ্যৎ রুট বিভাজনে আপডেটগুলি ইনস্টল করার সুযোগ দেয়। এটি সময় বাঁচায় কারণ এতে রিবুটের সময় অফলাইন আপডেটের প্রয়োজন হয় না।
+
+## কার্নেল প্যারামিটারসমূহ
+
+`abroot` আপনাকে কাস্টম কার্নেল প্যারামিটারসমূহ সেট করার সুযোগ দেয়, যা কখনো কোনো ড্রাইভার বা কাস্টম সেটআপের ক্ষেত্রে প্রয়োজন হতে পারে। ডিফল্ট অবস্থায়, `abroot` `/etc/default/abroot_kargs` এ থাকা কন্টেন্টগুলো রিড করে, যা কখনোই সম্পাদনা করা **উচিত নয়**। এর পরিবর্তে, আপনার প্যারামিটারগুলো ম্যানেজ করতে নীচের কমান্ডটি ব্যবহার করুন :
+
+```bash
+sudo abroot kargs edit
+```
+
+উপরের কমান্ডটি প্যারামিটার ফাইলটি ডিফল্ট কমান্ড-লাইন টেক্সট এডিটরে ওপেন করবে। (ডিফল্টটি হচ্ছে `nano`।)
+
+[কার্নেল প্যারামিটারসমূহ](https://www.kernel.org/doc/html/v4.14/admin-guide/kernel-parameters.html) অবশ্যই স্পেস ব্যবহারের মাধ্যমে আলাদা রাখতে হবে এবং তাদের মাঝে কোনোভাবেই কোনো লাইন ব্রেক (নতুন লাইন) থাকতে **পারবে না**। আরও লক্ষনীয়, আপনার কোনোভাবেই ডিফল্ট প্যারামিটারগুলি অপসারণ করা উচিত হবে না যদি না জানেন আপনি কী করছেন। কারণ এগুলো পরিবর্তনের কারণে আপনার সিস্টেম আনবুটেবল হয়ে যেতে পারে।
+
+**দ্রষ্টব্য**: কার্নেল প্যারামিটারগুলি শুধুমাত্র আপনার ভবিষ্যৎ রুটে প্রয়োগ করা হবে। তাই কোনো সমস্যা হলে আপনি যে কোনো সময় পূর্বের রুটে প্রবেশ করতে পারবেন।
+
+## নামকরণ
+
+এবিরুট নামটি দুইটি এ ও বি (A⟺B) রুট বিভাজনের মাঝে অদলবদল প্রক্রিয়ার দিকে ইঙ্গিত করে।
+
+## ব্যবহার
+
+- [ম্যানপেজ সহায়িকা](abroot-manpage)
+- [আপনার ডিস্ট্রিবিউশনে পোর্ট করুন](abroot-porting)

articles/bn/abroot.md

@@ -0,0 +1,55 @@
+---
+Title: প্যাকেজ ম্যানেজার (apx) - ভ্যানিলা ওএস
+Description: কীভাবে ভ্যনিলা ওএস প্যাকেজ ম্যানেজার apx ব্যবহার করতে হয় তা জানুন।
+Listed: true
+Authors: 
+  - Frost-OS
+---
+
+`apx` হচ্ছে ভ্যানিলা ওএস প্যাকেজ ম্যানেজার যা ব্যবহার করা খুবই সহজ এবং এটি রুট ফাইল ব্যবস্থাপনায় কোনো পরিবর্তন ব্যতিতই কন্টেইনারের ভিতরে বিভিন্ন উৎস থেকে প্যাকেজ ইন্সটল করা সমর্থন করে।
+
+## যেভাবে এটি কাজ করে
+
+`apx` প্যাকেজ ম্যানেজমেন্টের জগতে অভিনব এক পন্থা উপস্থাপন করেছে। বুদ্ধিটা হচ্ছে, আপনার সিস্টেমকে শুধুমাত্র
+আপনার ফাইলপত্র জমা রাখার একটি বাক্স হিসেবে ব্যবহার করবেন। যা একে বিভিন্ন প্যাকেজ থেকে মুক্ত রাখবে
+আর এটি অসম্পূর্ণ, পারিপাট্যহীন ভাবে তৈরি অথবা সংঘাতময় প্যাকেজের কারণে নষ্ট হয়ে যাওয়ার ঝুঁকি কমিয়ে দিবে।
+
+এটি করা সম্ভব 'apx' কর্তৃক নিয়ন্ত্রিত এক বা একাধিক কন্টেইনারের মধ্যে সফটওয়্যার ইনস্টল করার মাধ্যমে। আপনার সিস্টেম রিসোর্সের প্রতি এর এক্সেস সীমাবদ্ধ থাকে। তবুও এটি সিস্টেমে থাকা একই ড্রাইভার, ডিস্প্লে সার্ভার ইত্যাদি ব্যবহার করতে পারে।
+
+আপনার হোম ডিরেক্টরি কনটেইনারের ভিতরেও ম্যাপ করা থাকে। তাই আপনি হোমে থাকা সকল কনফিগ ফাইল,
+সেটিংস, অন্যান্য প্রয়োজনীয় ড্যাটা কন্টেইনারে ভিতর ইনস্টল করা প্যাকেজেও এক্সেস করতে পারবেন। একইভাবে সকল
+ফাইল কন্টেইনারে থাকা সফটওয়্যারে এক্সেস করতে পারবেন। (যেমন হোমে থাকা কোনো ডকুমেন্ট ফাইল কন্টেইনারে থাকা লিব্রাঅফিসে ওপেন করতে পারবেন।)
+
+### হোস্ট সিস্টেম
+
+যদিও হোস্ট সিস্টেমে সফটওয়্যার ইনস্টল করাটা এই প্রকল্পের আদর্শের সাথে সাংঘর্ষিক, তবু কখনো কখনো এটি জরুরিও হতে পারে। উদাহরণস্বরূপ, যখন আপনার কোনো কার্নেল মড্যুল বা ড্রাইভার
+ইন্সটল করার দরকার হয়।
+
+এসব ক্ষেত্রে আপনি কন্টেইনারকে পাশ কাটিয়ে সরাসরি হোস্টে ইনস্টল করতে চাইলে `abroot exec apt install <package_name>` অথবা `abroot shell apt install <package_name>` ব্যবহার করতে পারেন।
+কিন্তু সতর্ক থাকবেন, এই পন্থাটি প্রণিধানযোগ্য নয়।
+
+### বিভিন্ন উৎস
+
+ডিফল্ট ভাবে `apx` আপনার ডিস্ট্রিবিউশনের উপর ভিত্তি করে একটি কনটেইনার প্রদান করে (ভ্যানিলা ওএস ২২.১০ এ উবুন্টু ২২.১০ প্রদান করা হয়)
+আর এটি ঐ ডিস্ট্রিবিউশনের প্যাকেজ ম্যানেজারের সকল কমান্ড অন্তর্ভুক্ত করে (যেমন উবুন্টুতে `apt`)।
+
+যাইহোক, আপনি চাইলে অন্য ডিস্ট্রিবিউশন থেকেও প্যাকেজ ইনস্টল করতে পারবেন। উদাহরণস্বরূপ, `--aur` ফ্লাগ ব্যবহার করলে
+আর্চ লিনাক্স ভিত্তিক নতুন একটি কনটেইনার তৈরি হবে। এখানে `apx` আপনার হোস্ট সিস্টেমের সাথে শক্ত ভাবে সমন্বয় করে
+AUR (Pacman ও yay) প্যাকেজগুলি নিয়ন্ত্রণ করবে।
+
+`apx`-এর সাথে `--dnf` ফ্লাগ ব্যবহার করলে এটি একটি নতুন ফেডোরা ভিত্তিক কনটেইনার তৈরি করবে।
+এখানে `apx` আপনার হোস্ট সিস্টেমের সাথে শক্ত ভাবে সমন্বয় করে ফেডোরার ডিএনএফ উৎসে থাকা প্যাকেজগুলি নিয়ন্ত্রণ করবে।
+
+`apx` কনটেইনারের ভিতর তৈরি হওয়া গ্রাফিক্যাল ইউজার ইন্টারফেস যুক্ত প্যাকেজগুলির জন্য স্বয়ংক্রিয়ভাবে .desktop ফাইল তৈরি করা হয় এবং অ্যাপ্লিকেশন মেন্যুতে যোগ করা হয়। এই অ্যাপ্লিকেশনগুলি ফাইল ম্যানেজারের "Open with" (অন্য অ্যাপে খুলুন) মেন্যুতে থাকা অ্যাপগুলির সাথে প্রদর্শিত হয়। কনটেইনারের ভিতরে থাকা গ্রাফিক্যাল ইন্টারফেস যুক্ত প্যাকেজগুলি [ভ্যানিলা নিয়ন্ত্রণ কেন্দ্রের](/docs/vanilla-control-center) সাবসিস্টেম সেকশনে প্রদর্শিত হয়।
+
+গুণগত মান নিয়ন্ত্রণে রাখতে আমরা এই বৈশিষ্ট্যটি নির্দিষ্ট কিছু বাস্তবায়নে সীমাবদ্ধ রাখছি। আপাতত শুধু `--aur` ও `--dnf` ফ্লাগ দুটি সমর্থিত।
+কিন্তু আমরা ভবিষ্যতে নিক্স প্যাকেজ ম্যানেজমেন্ট সমর্থনও বাস্তবায়ন করব।
+
+### নামকরণ
+
+`apx` নামটি মূলত ডেবিয়ান ও তা থেকে উৎপত্ত ডিস্ট্রোগুলিতে ব্যবহৃত  **apt (Advanced Packaging Tool)** থেকে এসেছে। **X** এ দুটি রেখা রয়েছে (হোস্ট ও কন্টেইনার) যা পরস্পরকে ছেদ করে। এখানে কন্টেইনারটি উপরে, অর্থাৎ
+হোস্ট সিস্টেমের উপরে অবস্থান করে।
+
+## ব্যবহার
+
+- [ম্যানপেজ সহায়িকা](apx-manpage)