Merge branch 'dev' into pr/14541

Author: wackerow

.all-contributorsrc

@@ -4039,7 +4039,9 @@
       "profile": "https://github.com/lukassim",
       "contributions": [
         "content",
-        "ideas"
+        "ideas",
+        "translation",
+        "bug"
       ]
     },
     {
@@ -6239,10 +6241,10 @@
       ]
     },
     {
-      "login": "mradziwon",
-      "name": "mradziwon",
+      "login": "maciejrrr",
+      "name": "maciejrrr",
       "avatar_url": "https://avatars.githubusercontent.com/u/6785984?v=4",
-      "profile": "http://www.linkedin.com/in/mradziwon",
+      "profile": "http://www.linkedin.com/in/maciejrrr",
       "contributions": [
         "code",
         "bug"
@@ -10179,7 +10181,8 @@
       "avatar_url": "https://avatars.githubusercontent.com/u/84749041?v=4",
       "profile": "http://uniyj.eth",
       "contributions": [
-        "content"
+        "content",
+        "maintenance"
       ]
     },
     {
@@ -11685,7 +11688,8 @@
       "avatar_url": "https://avatars.githubusercontent.com/u/6020891?v=4",
       "profile": "http://www.edukids.cz",
       "contributions": [
-        "eventOrganizing"
+        "eventOrganizing",
+        "maintenance"
       ]
     },
     {
@@ -12657,10 +12661,265 @@
       "login": "mseidlx",
       "name": "Matthias Seidl",
       "avatar_url": "https://avatars.githubusercontent.com/u/32496674?v=4",
-      "profile": "https://growthepie.xyz",
+      "profile": "https://growthepie.com",
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "JoeChenJ",
+      "name": "JoeChenJ",
+      "avatar_url": "https://avatars.githubusercontent.com/u/171761102?v=4",
+      "profile": "https://github.com/JoeChenJ",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "itzVarsha",
+      "name": "Varshitha",
+      "avatar_url": "https://avatars.githubusercontent.com/u/138134029?v=4",
+      "profile": "https://github.com/itzVarsha",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "alexandriaroberts",
+      "name": "Alexandria Roberts",
+      "avatar_url": "https://avatars.githubusercontent.com/u/31341867?v=4",
+      "profile": "https://alexandriaroberts.dev/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "colinlyguo",
+      "name": "colin",
+      "avatar_url": "https://avatars.githubusercontent.com/u/102356659?v=4",
+      "profile": "https://github.com/colinlyguo",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "jenish-thapa",
+      "name": "Jenish Thapa",
+      "avatar_url": "https://avatars.githubusercontent.com/u/141203631?v=4",
+      "profile": "https://github.com/jenish-thapa",
+      "contributions": [
+        "ideas"
+      ]
+    },
+    {
+      "login": "iusx",
+      "name": "iusx",
+      "avatar_url": "https://avatars.githubusercontent.com/u/57232813?v=4",
+      "profile": "https://jiangxue.org/~ritsu",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "JJOptimist",
+      "name": "JJOptimist",
+      "avatar_url": "https://avatars.githubusercontent.com/u/86833563?v=4",
+      "profile": "https://github.com/JJOptimist",
+      "contributions": [
+        "bug"
+      ]
+    },
+    {
+      "login": "hotequil",
+      "name": "João Paulo Hotequil",
+      "avatar_url": "https://avatars.githubusercontent.com/u/46814712?v=4",
+      "profile": "https://github.com/hotequil",
+      "contributions": [
+        "code",
+        "translation"
+      ]
+    },
+    {
+      "login": "microHoffman",
+      "name": "microHoffman",
+      "avatar_url": "https://avatars.githubusercontent.com/u/61500778?v=4",
+      "profile": "http://pwn.xyz",
+      "contributions": [
+        "bug"
+      ]
+    },
+    {
+      "login": "smithrashell",
+      "name": "Rashell Smith",
+      "avatar_url": "https://avatars.githubusercontent.com/u/36465023?v=4",
+      "profile": "https://github.com/smithrashell",
+      "contributions": [
+        "bug"
+      ]
+    },
+    {
+      "login": "aolson078",
+      "name": "Alex Olson",
+      "avatar_url": "https://avatars.githubusercontent.com/u/69769089?v=4",
+      "profile": "https://github.com/aolson078",
+      "contributions": [
+        "bug"
+      ]
+    },
+    {
+      "login": "adminsuci",
+      "name": "SUCI - Blockchain Hub Team",
+      "avatar_url": "https://avatars.githubusercontent.com/u/155696196?v=4",
+      "profile": "https://www.suci.io/",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "Nik-EpicWeb3",
+      "name": "Nik-EpicWeb3",
+      "avatar_url": "https://avatars.githubusercontent.com/u/214466248?v=4",
+      "profile": "https://github.com/Nik-EpicWeb3",
+      "contributions": [
+        "eventOrganizing"
+      ]
+    },
+    {
+      "login": "brossetti1",
+      "name": "Brian Rossetti",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5998100?v=4",
+      "profile": "https://github.com/brossetti1",
+      "contributions": [
+        "maintenance",
+        "code"
+      ]
+    },
+    {
+      "login": "Antoine-Sparenberg",
+      "name": "Antoine-Sparenberg",
+      "avatar_url": "https://avatars.githubusercontent.com/u/128523213?v=4",
+      "profile": "https://github.com/Antoine-Sparenberg",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "kks-code",
+      "name": "Kendra Karol Sevilla",
+      "avatar_url": "https://avatars.githubusercontent.com/u/214244795?v=4",
+      "profile": "https://github.com/kks-code",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "otc-png",
+      "name": "otc group",
+      "avatar_url": "https://avatars.githubusercontent.com/u/214395681?v=4",
+      "profile": "https://github.com/otc-png",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "Savio-Sou",
+      "name": "Savio",
+      "avatar_url": "https://avatars.githubusercontent.com/u/72797635?v=4",
+      "profile": "https://github.com/Savio-Sou",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "vtjl10",
+      "name": "fuder.eth",
+      "avatar_url": "https://avatars.githubusercontent.com/u/139509124?v=4",
+      "profile": "https://github.com/vtjl10",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "CXYZTW",
+      "name": "@karelxfi",
+      "avatar_url": "https://avatars.githubusercontent.com/u/54091831?v=4",
+      "profile": "https://github.com/CXYZTW",
+      "contributions": [
+        "tool"
+      ]
+    },
+    {
+      "login": "gorbatiukcom",
+      "name": "Oleg Gorbatiuk",
+      "avatar_url": "https://avatars.githubusercontent.com/u/35546483?v=4",
+      "profile": "https://www.linkedin.com/in/gorbatiuk/",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "deca12x",
+      "name": "deca",
+      "avatar_url": "https://avatars.githubusercontent.com/u/74135582?v=4",
+      "profile": "https://github.com/deca12x",
+      "contributions": [
+        "eventOrganizing"
+      ]
+    },
+    {
+      "login": "Anish-Gupta1",
+      "name": "Anish Gupta ",
+      "avatar_url": "https://avatars.githubusercontent.com/u/180473292?v=4",
+      "profile": "https://github.com/Anish-Gupta1",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "rohitt-gupta",
+      "name": "Rohit Gupta",
+      "avatar_url": "https://avatars.githubusercontent.com/u/81370462?v=4",
+      "profile": "https://rohitt.in",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "rvmz",
+      "name": "Roman Mazurenko",
+      "avatar_url": "https://avatars.githubusercontent.com/u/92804957?v=4",
+      "profile": "https://github.com/rvmz",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "standstaff",
+      "name": "ZhengXingRu",
+      "avatar_url": "https://avatars.githubusercontent.com/u/163401255?v=4",
+      "profile": "https://github.com/standstaff",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "imbarty",
+      "name": "barty",
+      "avatar_url": "https://avatars.githubusercontent.com/u/191963641?v=4",
+      "profile": "https://github.com/imbarty",
+      "contributions": [
+        "bug"
+      ]
+    },
+    {
+      "login": "futreall",
+      "name": "futreall",
+      "avatar_url": "https://avatars.githubusercontent.com/u/86553580?v=4",
+      "profile": "https://github.com/futreall",
+      "contributions": [
+        "translation",
+        "bug"
+      ]
     }
   ],
   "contributorsPerLine": 7,

.claude/commands/update-llms-txt.md

@@ -0,0 +1,87 @@
+# Update LLMS.txt Command
+
+This command helps maintain the `public/llms.txt` file by monitoring key navigation files:
+
+1. **Main Navigation**: `src/components/Nav/useNavigation.ts`
+2. **Developer Docs**: `src/data/developer-docs-links.yaml`
+3. **Footer Links**: `src/components/Footer.tsx`
+
+## How it works
+
+- Adds missing links to appropriate sections
+- Preserves existing descriptions and organization
+- Follows established llms.txt structure
+- **Prefers static markdown files URLs over html URLs** for better LLM comprehension
+
+## Implementation
+
+When this command is executed, I will:
+
+### Step 1: Parse Navigation Files
+
+**Main Navigation** (`src/components/Nav/useNavigation.ts`):
+
+```javascript
+// Extract linkSections object structure
+// Parse learn, use, build, participate sections
+// Get href, label, and description for each link
+```
+
+**Developer Docs** (`src/data/developer-docs-links.yaml`):
+
+```yaml
+# Parse foundational-topics, ethereum-stack, advanced, design-fundamentals
+# Extract href and id mappings
+# Build hierarchical structure
+```
+
+**Footer Links** (`src/components/Footer.tsx`):
+
+```javascript
+// Extract linkSections and dipperLinks arrays
+// Get all footer navigation items
+// Include external links (blog, ESP, Devcon)
+```
+
+### Step 2: Analyze Current llms.txt
+
+- Parse existing sections and their links
+- Extract current URLs and descriptions
+- Identify section organization and hierarchy
+
+### Step 3: URL to Markdown File Mapping
+
+**Priority: Static markdown files URLs over web html URLs**
+
+For each link, I will:
+
+1. Check if corresponding markdown file exists in `public/content/`. **Ignore translations**: Skip `public/content/translations/` directory (60+ language versions)
+2. Use a URL pointing to the markdown file for the page: `https://ethereum.org/content/[page]/index.md`
+3. Fall back to web URL only if no markdown file exists
+4. Example: `https://ethereum.org/learn/` → `https://ethereum.org/content/learn/index.md`
+5. Example2: `https://ethereum.org/guides/how-to-use-a-wallet/` → `https://ethereum.org/content/guides/how-to-use-a-wallet/index.md`
+
+### Step 4: Smart Link Categorization
+
+New links are categorized using these rules:
+
+1. **Learn Section**: `/learn/`, `/what-is-*`, `/guides/`, `/quizzes/`, `/glossary/`
+2. **Use Section**: `/get-eth`, `/wallets/`, `/dapps/`, `/staking/`, use cases
+3. **Build Section**: `/developers/`, `/enterprise/`, developer tools
+4. **Participate Section**: `/community/`, `/contributing/`, `/foundation/`
+5. **Research Section**: `/whitepaper`, `/roadmap/`, `/eips/`, `/governance/`
+
+### Step 5: Validation & Quality Checks
+
+- Verify all markdown files exist in `public/content/`
+- Check for duplicate links within sections
+- Validate section organization and hierarchy
+- Ensure descriptions are informative and concise
+
+### Step 6: Execute Action
+
+Update llms.txt file with improved structure and validated links
+
+---
+
+The command ensures the llms.txt file remains comprehensive and current with minimal manual maintenance.