Differences

This shows you the differences between two versions of the page.

--- ai_wiki [2025/12/26 10:04] – Auto-fix: Apply dokuwiki linter fixes mike
+++ ai_wiki [2026/01/02 12:59] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== AI Wiki Tools and Suggestions ======
+This page documents tools and suggestions that could be beneficial for AI-assisted wiki maintenance and improvement for the Remixed Dungeon wiki.
+==== Current AI-Assisted Processes ====
+  * Manual checking of wiki pages against codebase (Java, Lua, JSON configs)
+  * Verification of game mechanics against source implementation
+  * Updating of code references and string resources in wiki pages
+  * Creation of missing wiki pages for entities referenced in code
+  * Renaming of wiki pages to follow proper naming conventions
+  * Cross-referencing between different language versions of wiki pages
+==== Suggested Tools for AI-Assisted Wiki Maintenance ====
+===== 1. Automated Entity Documentation Generator =====
+A tool that automatically scans the codebase for entities (mobs, items, spells, etc.) and generates skeleton documentation pages with:
+  * Basic stats and properties extracted from code
+  * Direct links to source code files
+  * References to relevant string resources
+  * Suggested category classifications based on entity types
+===== 2. Code-Wiki Synchronization Checker =====
+A tool that regularly compares game code with wiki documentation to identify:
+  * Outdated statistics or mechanics on wiki pages
+  * New game features that lack wiki documentation
+  * Discrepancies between implemented mechanics and documented ones
+===== 3. Multi-Language Content Consistency Verifier =====
+A tool that ensures content consistency across different language versions of the same wiki page, including:
+  * Cross-referencing of equivalent content
+  * Verification that translated pages contain the same information as source language
+  * Identification of pages that exist in one language but not others
+===== 4. Auto-Link Validation Tool =====
+A more comprehensive version of the existing red link checker that:
+  * Identifies missing pages that should exist based on codebase entities
+  * Suggests appropriate wiki page names for missing entities
+  * Validates that all code references in wiki pages still exist in the current codebase
+===== 5. Wiki Syntax and Style Checker =====
+A tool for ensuring consistency in wiki formatting that checks for:
+  * Consistent heading structures
+  * Proper use of tags and categories
+  * Consistent formatting of data tables
+  * Proper naming conventions for page files
+===== 6. Automated Image/Asset Linker =====
+A tool that:
+  * Matches game sprites with appropriate wiki pages
+  * Generates proper DokuWiki image syntax
+  * Suggests image positioning in wiki content
+  * Verifies existing image links are still valid
+==== Implementation Suggestions ====
+  * Integration with CI/CD pipeline to automatically check for wiki inconsistencies
+  * Regular automated reports of wiki health statistics
+  * Integration with GitHub Actions for automated wiki maintenance tasks
+  * APIs or tools that allow AI agents to contribute to wiki maintenance directly
+==== AI Integration Opportunities ====
+  * Natural language processing to extract more detailed information from code comments
+  * Machine learning models trained on existing wiki content to suggest new content
+  * Automated translation verification between different language versions
+  * Intelligent suggestions for content improvements based on player questions or forum discussions
+==== Additional Tool Suggestions from January 2026 Maintenance ====
+===== MR Namespace Generator =====
+  * A script that automatically generates missing mr: namespace pages based on entity lists
+  * Should be able to scan the codebase and generate basic pages with code references
+  * Should follow the pattern: {entity_name}_{type} (e.g., skeleton_mob, ankh_item, heal_spell, burning_buff)
+  * During this maintenance session, we identified the need for more comprehensive mr: namespace pages for various entities
+===== Auto-Linker Tool =====
+  * A script that identifies terms in wiki pages that have corresponding wiki pages and adds appropriate links
+  * Should avoid creating duplicate links
+  * Should be configurable to follow the proper naming conventions
+  * This tool would help maintain consistency in internal linking as the wiki grows
+===== Content Consistency Checker =====
+  * Validates that all wiki pages follow the established format
+  * Checks for proper code references in "Code References" sections
+  * Verifies that pages contain appropriate DokuWiki syntax
+  * Could be implemented as a linter for DokuWiki syntax compliance
+===== Statistics Generator =====
+  * Provides metrics on wiki completeness (coverage of game entities)
+  * Tracks pages that lack code references
+  * Monitors update frequency and outdated content
+  * Would help identify areas of the wiki needing attention
+===== Automated Redlink Resolver =====
+  * More sophisticated than current redlink checker
+  * Suggests similar pages that might have been intended
+  * Provides templates for creation of missing pages
+  * During this session, we confirmed that most internal links were valid
+===== Code Change Tracker =====
+  * Tool that monitors git changes in the codebase
+  * Suggests wiki pages that might need updates based on code changes
+  * Could be integrated into CI/CD to flag potential documentation gaps
+  * Especially useful for tracking when game mechanics change in updates
+===== Automated Naming Convention Enforcer =====
+  * Tool that automatically checks and potentially fixes file naming inconsistencies
+  * Validates that all pages follow the snake_case with appropriate suffixes (_mob, _item, _spell, etc.)
+  * Could run as a pre-commit hook to prevent naming issues
+  * During this session, we had to manually fix several naming issues (beehive.txt → beehive_mob.txt, scorpio.txt → scorpio_mob.txt, etc.)
+===== Multi-Language Link Consistency Tool =====
+  * Ensures that links to other language versions of pages are consistent and properly placed
+  * Checks that cross-language links are appropriately positioned (typically at the bottom of pages)
+  * Verifies that when an English page is updated, related language pages are checked for consistency
+==== Implementation Priority ====
+. **MR Namespace Generator** - Addresses the most glaring information gap
+. **Auto-Linker Tool** - Would significantly improve navigation and cross-referencing
+. **Content Consistency Checker** - Ensures quality and uniformity
+. **Statistics Generator** - Provides visibility into wiki completeness
+. **Automated Redlink Resolver** - Enhancement of existing functionality
+. **Code Change Tracker** - Advanced feature for ongoing maintenance
+==== Additional Resources Needed ====
+  * **Entity Database**:
+    - A comprehensive list of all in-game entities (mobs, items, spells, buffs, etc.)
+    - Should be generated from code/config files to ensure completeness
+    - Would serve as a checklist for wiki completeness
+  * **Game Data API**:
+    - A standardized way to extract game data for documentation
+    - Would make it easier to auto-generate parts of wiki pages
+    - Could also serve the game client for in-game help or tooltips
+  * **Template System**:
+    - Template files for different types of wiki pages
+    - Would ensure consistency while making creation of new pages easier
+    - Templates should be easily customizable but enforce essential sections
+{{tag> rpd ai wiki tools }}