refactor: knowledge base for all

Author: tanthanhdev

.editorconfig

@@ -0,0 +1,64 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Default settings for all files
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+# Markdown files
+[*.{md,markdown}]
+trim_trailing_whitespace = false  # Trailing whitespace is significant in Markdown
+
+# Python files
+[*.py]
+indent_size = 4
+max_line_length = 88  # Black formatter default
+
+# C# files
+[*.cs]
+indent_size = 4
+csharp_new_line_before_open_brace = all
+csharp_space_between_method_declaration_parameter_list_parentheses = false
+csharp_space_between_method_call_parameter_list_parentheses = false
+csharp_space_after_keywords_in_control_flow_statements = true
+csharp_space_between_parentheses = false
+
+# JavaScript/TypeScript files
+[*.{js,ts,jsx,tsx}]
+quote_type = single
+
+# JSON files
+[*.json]
+insert_final_newline = false
+
+# YAML files
+[*.{yml,yaml}]
+indent_size = 2
+
+# Shell scripts
+[*.sh]
+indent_size = 2
+
+# HTML, CSS, SCSS files
+[*.{html,css,scss}]
+indent_size = 2
+
+# Java files
+[*.java]
+indent_size = 4
+
+# Go files
+[*.go]
+indent_style = tab
+indent_size = 4
+
+# Makefiles
+[Makefile]
+indent_style = tab

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,30 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: 'bug'
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Additional context**
+Add any other context about the problem here.
+
+**Possible solution**
+If you have suggestions on how to fix the issue, please describe them here. 

.github/ISSUE_TEMPLATE/bug_report_vi.md

@@ -0,0 +1,30 @@
+---
+name: Báo cáo lỗi
+about: Tạo một báo cáo lỗi để giúp chúng tôi cải thiện
+title: '[BUG] '
+labels: 'bug'
+assignees: ''
+
+---
+
+**Mô tả lỗi**
+Mô tả ngắn gọn và rõ ràng về lỗi đang gặp phải.
+
+**Cách để tái tạo lỗi**
+Các bước để tái hiện hành vi lỗi:
+1. Truy cập vào '...'
+2. Nhấn vào '...'
+3. Cuộn xuống tới '...'
+4. Thấy lỗi
+
+**Hành vi mong đợi**
+Mô tả rõ ràng và ngắn gọn về điều bạn mong đợi sẽ xảy ra.
+
+**Ảnh chụp màn hình**
+Nếu có, hãy thêm ảnh chụp màn hình để minh họa lỗi.
+
+**Ngữ cảnh bổ sung**
+Thêm bất kỳ thông tin bổ sung nào về sự cố ở đây (thiết bị, trình duyệt, môi trường...).
+
+**Giải pháp khả thi**
+Nếu bạn có gợi ý về cách khắc phục lỗi, vui lòng mô tả tại đây.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: 'enhancement'
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
+
+**Target topics/areas**
+Which topics or sections of the repository would be affected by this feature? 

.github/ISSUE_TEMPLATE/feature_request_vi.md

@@ -0,0 +1,23 @@
+---
+name: Yêu cầu tính năng
+about: Đề xuất một ý tưởng hoặc tính năng cho dự án
+title: '[FEATURE] '
+labels: 'enhancement'
+assignees: ''
+
+---
+
+**Yêu cầu tính năng này có liên quan đến vấn đề nào không? Hãy mô tả.**
+Mô tả rõ ràng và ngắn gọn về vấn đề. Ví dụ: Tôi thường cảm thấy khó chịu khi [...]
+
+**Mô tả giải pháp bạn muốn có**
+Mô tả rõ ràng và ngắn gọn về điều bạn muốn xảy ra.
+
+**Mô tả các giải pháp thay thế bạn đã xem xét**
+Mô tả rõ ràng và ngắn gọn về bất kỳ giải pháp thay thế hoặc tính năng khác mà bạn đã cân nhắc.
+
+**Ngữ cảnh bổ sung**
+Thêm bất kỳ thông tin, bối cảnh hoặc ảnh chụp màn hình nào liên quan đến yêu cầu tính năng ở đây.
+
+**Các chủ đề/khu vực bị ảnh hưởng**
+Những chủ đề hoặc phần nào trong repository sẽ bị ảnh hưởng bởi tính năng này?

.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: Markdown CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  markdown-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 16
+      
+      - name: Install markdownlint-cli
+        run: npm install -g markdownlint-cli
+      
+      - name: Run markdownlint
+        run: markdownlint '**/*.md' --ignore node_modules
+        
+  check-links:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '16'
+      
+      - name: Install dependencies
+        run: npm install -g markdown-link-check
+      
+      - name: Check links
+        run: ./tools/check_links.sh
+        
+      - name: Generate TOC
+        run: |
+          python3 ./tools/generate_summary.py
+          git diff --exit-code SUMMARY.md || (echo "SUMMARY.md is out of date. Please run ./tools/generate_summary.py and commit the changes" && exit 1) 

.gitignore

@@ -3,11 +3,34 @@ node_modules/
 
 # Python
 __pycache__/
-*.pyc
-*.pyo
-*.pyd
-.env
-.venv/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# C#
+bin/
+obj/
+*.user
+*.suo
+*.userprefs
+*.sln.docstates
+.vs/
 
 # VSCode settings
 .vscode/
@@ -42,6 +65,8 @@ coverage.xml
 # dotenv environment files
 .env.local
 .env.*
+.env
+!.env.example
 
 # Ignore generated files and backups
 *.orig

.markdownlint.yml

@@ -0,0 +1,86 @@
+# Markdown linting rules for Tech Notes Hub
+# See https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md for details
+
+# Default state for all rules
+default: true
+
+# MD001 header-increment - Headers should increment by one level at a time
+MD001: true
+
+# MD003 header-style - Header style
+MD003:
+  style: "atx"  # Use # style headers
+
+# MD004 ul-style - Unordered list style
+MD004:
+  style: "consistent"
+
+# MD007 ul-indent - Unordered list indentation
+MD007:
+  indent: 2  # Use 2 spaces for indentation
+
+# MD009 no-trailing-spaces - No trailing spaces
+MD009: true
+
+# MD010 no-hard-tabs - No hard tabs
+MD010: true
+
+# MD012 no-multiple-blanks - Multiple consecutive blank lines
+MD012:
+  maximum: 1  # Allow at most 1 blank line
+
+# MD013 line-length - Line length
+MD013:
+  line_length: 120  # Allow longer lines for code blocks
+  code_blocks: false
+  tables: false
+
+# MD022 blanks-around-headers - Headers should be surrounded by blank lines
+MD022: true
+
+# MD024 no-duplicate-header - Multiple headers with the same content
+MD024:
+  siblings_only: true  # Allow same title in different nesting
+
+# MD025 single-title/single-h1 - Only one top-level header
+MD025: true
+
+# MD026 no-trailing-punctuation - No trailing punctuation in header
+MD026:
+  punctuation: ".,;:!。，；：！"
+
+# MD029 ol-prefix - Ordered list item prefix
+MD029:
+  style: "one_or_ordered"  # Use 1. or ordered numbers
+
+# MD031 blanks-around-fences - Fenced code blocks should be surrounded by blank lines
+MD031: true
+
+# MD032 blanks-around-lists - Lists should be surrounded by blank lines
+MD032: true
+
+# MD033 no-inline-html - No inline HTML
+MD033:
+  allowed_elements: ["br", "img", "a", "details", "summary"]
+
+# MD034 no-bare-urls - No bare URLs
+MD034: true
+
+# MD036 no-emphasis-as-header - No emphasis as header
+MD036: true
+
+# MD037 no-space-in-emphasis - No spaces inside emphasis markers
+MD037: true
+
+# MD038 no-space-in-code - No spaces inside code span markers
+MD038: true
+
+# MD040 fenced-code-language - Fenced code blocks should have a language specified
+MD040: true
+
+# MD041 first-line-heading - First line should be a top-level header
+MD041: true
+
+# MD046 code-block-style - Code block style
+MD046:
+  style: "fenced"  # Use ```code``` style

CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing to Tech Notes Hub
 
-First of all, thank you for taking the time to contribute! 🎉  
+First of all, thank you for taking the time to contribute! 🎉
 Your contributions help make this project more valuable for the developer community.
 
 ## 🚀 Ways to Contribute
@@ -74,14 +74,15 @@ Write clear, meaningful, and understandable commit messages. Suggested structure
 - `feature: add notes on HTTP Status Codes`
 - `fix: correct typos in design-patterns.md`
 - `update: improve binary search examples`
+- `refactor: reorganize folder structure`
 - `remove: delete duplicate notes in aws folder`
 - `docs: add instructions for creating pull requests`
 
 #### 🧠 Additional Tips:
 
 - You can only write in **English**
 - **Avoid vague commits** like: `update 1`, `fix bug`, `test`
-- If related to an issue, add the number at the end:  
+- If related to an issue, add the number at the end:
   👉 `fix: typo in aws-note #12`
 
 ### 5. Commit & Push
@@ -111,9 +112,9 @@ Before submitting, ensure:
 
 ## 📁 File & Folder Naming Conventions
 
-* Use lowercase and hyphens for file and folder names: `graph-traversal.md`
-* For translations, add language suffix: `graph-traversal_vi.md`
-* Notes should be grouped by topic folders (e.g., `algorithms/`, `aws/`, `design-patterns/`)
+* Use lowercase and hyphens for file and folder names: `graph_traversal.md` (except for code files like C# using PascalCase such as `GraphTraversal.cs`, or Java using CamelCase like `GraphTraversal.java`)
+* For translations, add language suffix: `graph_traversal_vi.md`
+* Notes should be grouped by docs folders (e.g., `docs/algorithms/`, `docs/aws/`, `docs/design-patterns/`)
 
 ## 🤝 Code of Conduct