diff --git a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/index.md b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/index.md index 671484d5..7e4b8105 100644 --- a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/index.md +++ b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/index.md @@ -2,7 +2,7 @@ title: "Manually on Windows 11" --- -This guide will walk You thrugh installing Hugo on a Windows 11 PC. For the official install guide, You can wisit . +This guide will walk You thrugh installing Hugo on a Windows 11 PC. For the official install guide, You can wisit . ## Download Binaries diff --git a/content/docs/Contributing/InstallHugo/_index.md b/content/docs/Contributing/InstallHugo/_index.md index b59eb861..30a2f7f6 100644 --- a/content/docs/Contributing/InstallHugo/_index.md +++ b/content/docs/Contributing/InstallHugo/_index.md @@ -4,6 +4,6 @@ title: Install Hugo There are multiple ways to install Hugo for you to properly preview your contributions. Please select the scenario that matches your setup. -For the official install guide, you can visit +For the official install guide, you can visit {{< youtube G7umPCU-8xc >}} diff --git a/content/docs/agentic-coding/CommunityResources/Agents/_index.md b/content/docs/agentic-coding/CommunityResources/Agents/_index.md index bd6e0f45..b463099f 100644 --- a/content/docs/agentic-coding/CommunityResources/Agents/_index.md +++ b/content/docs/agentic-coding/CommunityResources/Agents/_index.md @@ -159,8 +159,8 @@ Many developers use multiple agents for different tasks: ### New to AI Coding? 1. **Start Simple**: [GitHub Copilot](github-copilot-agent) -2. **Learn the Basics**: [Effective Prompting](../../getting-started/effective-prompting) -3. **Try Examples**: [Getting More](../../getting-more) +2. **Learn the Basics**: [Effective Prompting](../../gettingstarted/effective-prompting) +3. **Try Examples**: [Getting More](../../gettingmore) 4. **Explore Others**: Try Claude or Cursor for comparison ### Already Using AI? @@ -202,15 +202,15 @@ See individual agent pages for specific privacy information. 1. **Read agent pages** to understand capabilities 2. **Choose one** to start with 3. **Follow setup** instructions -4. **Practice** with examples from [Getting More](../../getting-more) +4. **Practice** with examples from [Getting More](../../gettingmore) 5. **Experiment** with others as needed ## Resources -- [Setup Guide](../../getting-started/setup) - Environment configuration -- [Effective Prompting](../../getting-started/effective-prompting) - Get better results -- [Best Practices](../../getting-started/best-practices) - Use AI effectively -- [Limitations](../../getting-started/limitations) - Understand constraints +- [Setup Guide](../../gettingstarted/setup) - Environment configuration +- [Effective Prompting](../../gettingstarted/effective-prompting) - Get better results +- [Best Practices](../../gettingstarted/best-practices) - Use AI effectively +- [Limitations](../../gettingstarted/limitations) - Understand constraints --- diff --git a/content/docs/agentic-coding/CommunityResources/Agents/claude-agent.md b/content/docs/agentic-coding/CommunityResources/Agents/claude-agent.md index 806ce4f4..828c5674 100644 --- a/content/docs/agentic-coding/CommunityResources/Agents/claude-agent.md +++ b/content/docs/agentic-coding/CommunityResources/Agents/claude-agent.md @@ -743,9 +743,9 @@ with pros and cons of each." - [API Documentation](https://docs.anthropic.com/claude/reference) ### AL Guidelines -- [Effective Prompting](../../getting-started/effective-prompting) -- [Best Practices](../../getting-started/best-practices) -- [Code Review Examples](../../getting-more/code-review) +- [Effective Prompting](../../gettingstarted/effective-prompting) +- [Best Practices](../../gettingstarted/best-practices) +- [Code Review Examples](../../gettingmore/code-review) --- diff --git a/content/docs/agentic-coding/CommunityResources/Agents/cursor-agent.md b/content/docs/agentic-coding/CommunityResources/Agents/cursor-agent.md index e6e25c23..4e5fdfd1 100644 --- a/content/docs/agentic-coding/CommunityResources/Agents/cursor-agent.md +++ b/content/docs/agentic-coding/CommunityResources/Agents/cursor-agent.md @@ -640,9 +640,9 @@ Poor: - [Community Discord](https://discord.gg/cursor) ### AL Guidelines -- [Effective Prompting](../../getting-started/effective-prompting) -- [Best Practices](../../getting-started/best-practices) -- [Getting More Examples](../../getting-more) +- [Effective Prompting](../../gettingstarted/effective-prompting) +- [Best Practices](../../gettingstarted/best-practices) +- [Getting More Examples](../../gettingmore) ## Learning Cursor diff --git a/content/docs/agentic-coding/CommunityResources/Agents/github-copilot-agent.md b/content/docs/agentic-coding/CommunityResources/Agents/github-copilot-agent.md index b688f7c1..d7f62dce 100644 --- a/content/docs/agentic-coding/CommunityResources/Agents/github-copilot-agent.md +++ b/content/docs/agentic-coding/CommunityResources/Agents/github-copilot-agent.md @@ -503,13 +503,13 @@ Before accepting Copilot suggestions: ### Official Resources - [GitHub Copilot Documentation](https://docs.github.com/copilot) - [VS Code Extension Page](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) -- [Getting Started Guide](https://docs.github.com/copilot/getting-started-with-github-copilot) +- [Getting Started Guide](https://docs.github.com/copilot/gettingstarted-with-github-copilot) ### AL Guidelines Resources -- [Setup Guide](../../getting-started/setup) -- [Effective Prompting](../../getting-started/effective-prompting) -- [Best Practices](../../getting-started/best-practices) -- [Code Review Examples](../../getting-more/code-review) +- [Setup Guide](../../gettingstarted/setup) +- [Effective Prompting](../../gettingstarted/effective-prompting) +- [Best Practices](../../gettingstarted/best-practices) +- [Code Review Examples](../../gettingmore/code-review) ## When to Use GitHub Copilot diff --git a/content/docs/agentic-coding/CommunityResources/Agents/github-copilot-chat-agent.md b/content/docs/agentic-coding/CommunityResources/Agents/github-copilot-chat-agent.md index ebc73ce8..378bbd5f 100644 --- a/content/docs/agentic-coding/CommunityResources/Agents/github-copilot-chat-agent.md +++ b/content/docs/agentic-coding/CommunityResources/Agents/github-copilot-chat-agent.md @@ -600,9 +600,9 @@ No separate charge - comes with Copilot subscription. - [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) ### AL Guidelines Resources -- [Effective Prompting](../../getting-started/effective-prompting) -- [Best Practices](../../getting-started/best-practices) -- [Getting More Examples](../../getting-more) +- [Effective Prompting](../../gettingstarted/effective-prompting) +- [Best Practices](../../gettingstarted/best-practices) +- [Getting More Examples](../../gettingmore) ## Complementary Tools diff --git a/content/docs/agentic-coding/CommunityResources/Tools/_index.md b/content/docs/agentic-coding/CommunityResources/Tools/_index.md index 9f334a79..8bddcda3 100644 --- a/content/docs/agentic-coding/CommunityResources/Tools/_index.md +++ b/content/docs/agentic-coding/CommunityResources/Tools/_index.md @@ -145,7 +145,7 @@ Share it with the community! ## Related Resources -- [Setup Guide](../../getting-started/setup) - Environment configuration +- [Setup Guide](../../gettingstarted/setup) - Environment configuration - [Blog Posts](../articles) - Tool reviews and comparisons - [Videos](../videos) - Tool demonstrations - [GitHub Discussions](https://github.com/microsoft/alguidelines/discussions) - Tool recommendations and support diff --git a/content/docs/agentic-coding/CommunityResources/_index.md b/content/docs/agentic-coding/CommunityResources/_index.md index bcc2926c..c98ceb4c 100644 --- a/content/docs/agentic-coding/CommunityResources/_index.md +++ b/content/docs/agentic-coding/CommunityResources/_index.md @@ -1,7 +1,7 @@ --- title: "Community Resources" linkTitle: "Community Resources" -weight: 30 +weight: 100 description: > Curated resources from the AL and Business Central community for agentic coding --- @@ -95,7 +95,7 @@ The community is grateful to developers who regularly share their knowledge abou ## Learning Paths ### For Beginners -1. Start with [Getting Started](../getting-started) in this hub +1. Start with [Getting Started](../gettingstarted) in this hub 2. Watch introductory videos about AI coding assistants 3. Read beginner-friendly blog posts 4. Try simple prompts with your own code diff --git a/content/docs/agentic-coding/CommunityResources/tools.md b/content/docs/agentic-coding/CommunityResources/tools.md index 368ad700..41e86422 100644 --- a/content/docs/agentic-coding/CommunityResources/tools.md +++ b/content/docs/agentic-coding/CommunityResources/tools.md @@ -563,7 +563,7 @@ Extensions are frequently updated. Check for updates regularly: ## Related Resources -- [Setup Guide](../../getting-started/setup) - Environment configuration +- [Setup Guide](../../gettingstarted/setup) - Environment configuration - [Blog Posts](../articles) - Tool reviews and comparisons - [Videos](../videos) - Tool demonstrations - [Discussions](../discussions) - Tool recommendations and support diff --git a/content/docs/agentic-coding/GettingMore/_index.md b/content/docs/agentic-coding/GettingMore/_index.md index 9d93daa1..432eea27 100644 --- a/content/docs/agentic-coding/GettingMore/_index.md +++ b/content/docs/agentic-coding/GettingMore/_index.md @@ -28,7 +28,7 @@ Each guide follows a practical, scenario-based approach: ## Before You Start -Make sure you've completed the [Getting Started](../getting-started) section to: +Make sure you've completed the [Getting Started](../gettingstarted) section to: - Understand agentic coding concepts - Set up your environment - Learn effective prompting diff --git a/content/docs/agentic-coding/GettingStarted/best-practices.md b/content/docs/agentic-coding/GettingStarted/best-practices.md index af52ca2b..28698b30 100644 --- a/content/docs/agentic-coding/GettingStarted/best-practices.md +++ b/content/docs/agentic-coding/GettingStarted/best-practices.md @@ -411,5 +411,5 @@ Ensure quality isn't suffering: ## Next Steps - Understand [AI limitations](../limitations) to know when caution is needed -- Try the [practical examples](../../getting-more) to apply these best practices +- Try the [practical examples](../../gettingmore) to apply these best practices - Explore [community resources](../../community-resources) for more tips and techniques diff --git a/content/docs/agentic-coding/GettingStarted/effective-prompting.md b/content/docs/agentic-coding/GettingStarted/effective-prompting.md index 390ba36d..d91ba1ab 100644 --- a/content/docs/agentic-coding/GettingStarted/effective-prompting.md +++ b/content/docs/agentic-coding/GettingStarted/effective-prompting.md @@ -354,5 +354,5 @@ Requirements: Now that you know how to write effective prompts: - Review the [best practices](../best-practices) for AI-assisted development -- Try the [practical examples](../../getting-more) with your new prompting skills +- Try the [practical examples](../../gettingmore) with your new prompting skills - Understand the [limitations](../limitations) of AI assistants diff --git a/content/docs/agentic-coding/GettingStarted/limitations.md b/content/docs/agentic-coding/GettingStarted/limitations.md index 5a447c5e..3d78b238 100644 --- a/content/docs/agentic-coding/GettingStarted/limitations.md +++ b/content/docs/agentic-coding/GettingStarted/limitations.md @@ -468,6 +468,6 @@ Extensive validation for: ## Next Steps Now that you understand AI limitations: -- Apply this knowledge in the [practical examples](../../getting-more) +- Apply this knowledge in the [practical examples](../../gettingmore) - See how to work within these limitations in [best practices](../best-practices) - Explore [community resources](../../community-resources) for more insights diff --git a/content/docs/agentic-coding/GettingStarted/setup.md b/content/docs/agentic-coding/GettingStarted/setup.md index e9349004..cd5b007f 100644 --- a/content/docs/agentic-coding/GettingStarted/setup.md +++ b/content/docs/agentic-coding/GettingStarted/setup.md @@ -223,4 +223,4 @@ src/ Now that your environment is set up: - Learn [effective prompting techniques](../effective-prompting) - Review [best practices](../best-practices) for AI-assisted development -- Try the [practical examples](../../getting-more) to see AI assistance in action +- Try the [practical examples](../../gettingmore) to see AI assistance in action diff --git a/content/docs/agentic-coding/_index.md b/content/docs/agentic-coding/_index.md index 0c88856e..44002af2 100644 --- a/content/docs/agentic-coding/_index.md +++ b/content/docs/agentic-coding/_index.md @@ -44,6 +44,15 @@ Practical examples and advanced techniques: - Refactoring legacy code - Testing strategies +### Vibe Coding Rules +Comprehensive AI-specific coding guidelines and instructions: +- AL code style and formatting rules +- Error handling patterns +- Event-driven architecture guidelines +- Performance optimization techniques +- Testing and upgrade code best practices +- Naming conventions and standards + ### Community Resources Curated resources from the AL and Business Central community: - Articles and blog posts diff --git a/content/docs/vibe-coding/README.md b/content/docs/agentic-coding/vibe-coding-rules/README.md similarity index 100% rename from content/docs/vibe-coding/README.md rename to content/docs/agentic-coding/vibe-coding-rules/README.md diff --git a/content/docs/vibe-coding/_index.md b/content/docs/agentic-coding/vibe-coding-rules/_index.md similarity index 93% rename from content/docs/vibe-coding/_index.md rename to content/docs/agentic-coding/vibe-coding-rules/_index.md index 8fa25383..4e4060e4 100644 --- a/content/docs/vibe-coding/_index.md +++ b/content/docs/agentic-coding/vibe-coding-rules/_index.md @@ -1,5 +1,5 @@ --- -title: "Vibe Coding for AL" +title: "Vibe Coding Rules for AL" weight: 90 tags: ["AL", "Vibe Coding"] categories: ["Vibe Coding"] @@ -9,9 +9,9 @@ description: > _Created by the Business Central Community, Enhanced for AI-powered AL Development_ -# Vibe Coding for AL +# Vibe Coding Rules for AL -Welcome to the **Vibe Coding for AL** initiative! This section contains AI-optimized coding rules and guidelines specifically designed to enhance the AL developer experience in modern AI-powered IDEs like VS Code and Cursor. +Welcome to the **Vibe Coding Rules for AL** initiative! This section contains AI-optimized coding rules and guidelines specifically designed to enhance the AL developer experience in modern AI-powered IDEs like VS Code and Cursor. ## What is Vibe Coding? diff --git a/content/docs/vibe-coding/al-code-style.md b/content/docs/agentic-coding/vibe-coding-rules/al-code-style.md similarity index 100% rename from content/docs/vibe-coding/al-code-style.md rename to content/docs/agentic-coding/vibe-coding-rules/al-code-style.md diff --git a/content/docs/vibe-coding/al-error-handling.md b/content/docs/agentic-coding/vibe-coding-rules/al-error-handling.md similarity index 100% rename from content/docs/vibe-coding/al-error-handling.md rename to content/docs/agentic-coding/vibe-coding-rules/al-error-handling.md diff --git a/content/docs/vibe-coding/al-events.md b/content/docs/agentic-coding/vibe-coding-rules/al-events.md similarity index 100% rename from content/docs/vibe-coding/al-events.md rename to content/docs/agentic-coding/vibe-coding-rules/al-events.md diff --git a/content/docs/vibe-coding/al-guidelines-rules.md b/content/docs/agentic-coding/vibe-coding-rules/al-guidelines-rules.md similarity index 100% rename from content/docs/vibe-coding/al-guidelines-rules.md rename to content/docs/agentic-coding/vibe-coding-rules/al-guidelines-rules.md diff --git a/content/docs/vibe-coding/al-naming-conventions.md b/content/docs/agentic-coding/vibe-coding-rules/al-naming-conventions.md similarity index 100% rename from content/docs/vibe-coding/al-naming-conventions.md rename to content/docs/agentic-coding/vibe-coding-rules/al-naming-conventions.md diff --git a/content/docs/vibe-coding/al-performance.md b/content/docs/agentic-coding/vibe-coding-rules/al-performance.md similarity index 100% rename from content/docs/vibe-coding/al-performance.md rename to content/docs/agentic-coding/vibe-coding-rules/al-performance.md diff --git a/content/docs/vibe-coding/al-testing.md b/content/docs/agentic-coding/vibe-coding-rules/al-testing.md similarity index 100% rename from content/docs/vibe-coding/al-testing.md rename to content/docs/agentic-coding/vibe-coding-rules/al-testing.md diff --git a/content/docs/vibe-coding/al-upgrade.md b/content/docs/agentic-coding/vibe-coding-rules/al-upgrade.md similarity index 100% rename from content/docs/vibe-coding/al-upgrade.md rename to content/docs/agentic-coding/vibe-coding-rules/al-upgrade.md