From 8a583c8edce24f5ea2c7e384a0499d888082a63d Mon Sep 17 00:00:00 2001 From: Jeremy Vyska Date: Fri, 17 Oct 2025 12:18:50 +0200 Subject: [PATCH] Curate videos.md: add 4 starter videos, contributor CTA, and quality criteria --- .../CommunityResources/articles.md | 48 +- .../CommunityResources/videos.md | 412 ++---------------- 2 files changed, 70 insertions(+), 390 deletions(-) diff --git a/content/docs/agentic-coding/CommunityResources/articles.md b/content/docs/agentic-coding/CommunityResources/articles.md index f553b972..06582916 100644 --- a/content/docs/agentic-coding/CommunityResources/articles.md +++ b/content/docs/agentic-coding/CommunityResources/articles.md @@ -14,34 +14,50 @@ This page curates blog posts, articles, and written guides from the Business Cen ### Getting Started -#### "My First Month with GitHub Copilot for AL Development" -**Author**: Community Contributor -**Published**: Example Date -**Summary**: A developer's experience adopting GitHub Copilot for AL development, including lessons learned, productivity gains, and common pitfalls. +#### "Vibe Coding — yes or no?" — Demiliani +**Author**: Demiliani +**Published**: 2025-08-21 +**Summary**: A thoughtful exploration of the Vibe Coding approach and whether its rules and conventions help or hinder real-world AL development. **Key Takeaways**: -- How to configure Copilot for optimal AL suggestions -- Prompting patterns that work well for AL -- Mistakes to avoid when starting out +- Pros and cons of strict Vibe Coding rules +- When to adopt vs. adapt guidance for your team +- Practical examples and trade-offs -**Link**: [Example - Replace with actual link when available] +**Link**: https://demiliani.com/2025/08/21/vibe-coding-yes-or-no/ --- -#### "Effective Prompting for Business Central Extensions" -**Author**: Community Contributor -**Published**: Example Date -**Summary**: Deep dive into writing effective prompts specifically for AL and Business Central development scenarios. +#### "Gestión de contexto y estados en servidores MCP" — TechSphere Dynamics +**Author**: TechSphere Dynamics +**Published**: 2025-08-15 +**Summary**: A Spanish-language deep dive into context handling and state management patterns for MCP servers, including practical patterns used in production systems. **Key Takeaways**: -- AL-specific prompting patterns -- How to provide context for better results -- Examples of before/after prompt improvements +- Context lifecycle and state management strategies +- Common pitfalls when preserving or discarding context +- Examples of robust MCP server patterns -**Link**: [Example - Replace with actual link when available] +**Link**: https://techspheredynamics.com/2025/08/15/gestion-de-contexto-y-estados-en-servidores-mcp/ --- +#### "Testing GitHub Copilot: knowledge engineering — what actually works and what doesn't" — Nubimancy +**Author**: Nubimancy +**Published**: 2025-09-09 +**Summary**: An empirical look at how well GitHub Copilot handles knowledge-engineering tasks, with experiments and practical recommendations for prompt authors. + +**Key Takeaways**: +- Which prompting patterns produce reliable results +- When Copilot is prone to hallucination or brittle outputs +- Strategies to validate and refine AI-suggested knowledge artifacts + +**Link**: https://nubimancy.com/2025/09/09/testing-github-copilot-knowledge-engineering-what-actually-works-and-what-doesnt/ + +--- + +Each of these are just "great examples" from those blogs, so make sure to explore around! + ### Advanced Techniques #### "Using AI to Modernize Legacy NAV Code" diff --git a/content/docs/agentic-coding/CommunityResources/videos.md b/content/docs/agentic-coding/CommunityResources/videos.md index 1c0139bd..dc114325 100644 --- a/content/docs/agentic-coding/CommunityResources/videos.md +++ b/content/docs/agentic-coding/CommunityResources/videos.md @@ -1,402 +1,66 @@ --- +--- title: "Video Tutorials" linkTitle: "Videos" weight: 2 description: > - Video content demonstrating AI-assisted AL development techniques + Curated videos demonstrating AI-assisted AL development techniques --- ## Overview -Visual learning resources showing AI coding assistants in action for Business Central development. These videos demonstrate real workflows, techniques, and best practices. +Short, curated videos that show AI coding assistants in practical AL/Business Central workflows. The list below is a starting point — contribute more quality content via the contributing process. -## Getting Started Videos +## Curated Videos (starter list) -### Introduction to AI Coding for AL -**Channel**: Community Channel -**Duration**: ~15 minutes -**Level**: Beginner +1. "Vibe Coding: Yes or No?" — demiliani + - Link: https://www.youtube.com/watch?v=vY5WfipEK8M + - Quick: discussion and viewpoints on the "vibe coding" approach when using AI assistants -**What You'll Learn**: -- Setting up GitHub Copilot for AL development -- First steps with AI assistance -- Basic prompting techniques -- Common mistakes to avoid +2. "Gestion de Contexto y Estados en Servidores MCP" — techspheredynamics + - Link: https://www.youtube.com/watch?v=PzEbaPw-E1o + - Quick: context and state management patterns for MCP servers (Spanish) -**Topics Covered**: -- Installation and configuration -- Writing your first AI-assisted AL code -- Understanding suggestions -- Accepting and modifying completions +3. "Testing GitHub Copilot Knowledge Engineering" — nubimancy + - Link: https://www.youtube.com/watch?v=K8nFVw5M-Po + - Quick: experiments and lessons around prompting and knowledge engineering for Copilot -**Link**: [Example - Replace with actual link when available] - ---- - -### Configuring VS Code for Optimal AI Assistance -**Channel**: Community Channel -**Duration**: ~10 minutes -**Level**: Beginner - -**What You'll Learn**: -- VS Code settings for AL + AI -- Workspace configuration -- Extension setup -- Optimizing for better suggestions - -**Link**: [Example - Replace with actual link when available] - ---- - -## Technique Demonstrations - -### Effective Prompting for AL Development -**Channel**: Community Channel -**Duration**: ~20 minutes -**Level**: Intermediate - -**Demonstrations**: -- Writing clear, specific prompts -- Providing context for better results -- Iterative refinement -- Prompt patterns that work for AL - -**Example Scenarios**: -- Creating table extensions -- Generating page code -- Writing codeunit logic -- Building API pages - -**Link**: [Example - Replace with actual link when available] - ---- - -### Live Coding: Building a Feature with AI -**Channel**: Community Channel -**Duration**: ~30 minutes -**Level**: Intermediate - -**Watch As**: -- Complete feature built with AI assistance -- Real-time problem solving -- Code review and refinement -- Testing and debugging - -**Feature Built**: Customer loyalty points system - -**Link**: [Example - Replace with actual link when available] - ---- - -## Advanced Workflows - -### AI-Assisted Code Refactoring -**Channel**: Community Channel -**Duration**: ~25 minutes -**Level**: Advanced - -**Demonstrations**: -- Analyzing legacy code -- Planning refactoring with AI -- Executing transformations -- Validating changes - -**Before/After**: Real code transformation examples - -**Link**: [Example - Replace with actual link when available] - ---- - -### Adding Telemetry with AI Assistance -**Channel**: Community Channel -**Duration**: ~20 minutes -**Level**: Advanced - -**Step-by-Step**: -- Planning telemetry strategy -- Generating telemetry code -- Creating custom dimensions -- Testing telemetry output - -**Link**: [Example - Replace with actual link when available] - ---- - -### Building Test Coverage with AI -**Channel**: Community Channel -**Duration**: ~30 minutes -**Level**: Advanced - -**Covers**: -- Test planning with AI -- Generating test codeunits -- Creating test data -- Running and debugging tests - -**Link**: [Example - Replace with actual link when available] - ---- - -## Real-World Projects - -### Case Study: Migrating NAV to BC with AI -**Channel**: Company Channel -**Duration**: ~45 minutes -**Level**: Advanced - -**Complete Walkthrough**: -- Project scope and planning -- AI-assisted code conversion -- Manual review process -- Quality assurance -- Results and lessons learned - -**Metrics Shared**: Time savings, accuracy rates - -**Link**: [Example - Replace with actual link when available] - ---- - -### Building a Complete Extension from Scratch -**Channel**: Community Channel -**Duration**: ~60 minutes (multi-part) -**Level**: Intermediate - -**Full Development Cycle**: -- Requirements gathering -- Architecture design -- Implementation with AI -- Testing -- Documentation -- Deployment - -**Extension Built**: Warehouse management enhancement - -**Link**: [Example - Replace with actual link when available] - ---- - -## Tips & Tricks - -### "5-Minute AL AI Tips" Series -**Channel**: Community Channel -**Episodes**: 20+ -**Duration**: ~5 minutes each -**Level**: All - -**Topics Include**: -- Quick productivity hacks -- Useful prompt templates -- Keyboard shortcuts -- Common pitfalls to avoid -- Integration tips - -**Link**: [Playlist - Replace with actual link when available] - ---- - -### AI Shortcuts Every AL Developer Should Know -**Channel**: Community Channel -**Duration**: ~15 minutes -**Level**: All - -**Quick Wins**: -- Fast code generation -- Smart completions -- Context switching -- Multi-file operations - -**Link**: [Example - Replace with actual link when available] - ---- - -## Tool-Specific Tutorials - -### GitHub Copilot for AL Developers -**Channel**: GitHub or Community -**Duration**: ~25 minutes -**Level**: Beginner to Intermediate - -**Specific to GitHub Copilot**: -- Installation and setup -- Chat vs inline suggestions -- Slash commands -- Best practices for AL - -**Link**: [Example - Replace with actual link when available] - ---- - -### Using AI in VS Code for Business Central -**Channel**: Microsoft or Community -**Duration**: ~20 minutes -**Level**: Beginner - -**VS Code Integration**: -- Extension setup -- Keyboard shortcuts -- Chat interface -- Multi-file context - -**Link**: [Example - Replace with actual link when available] - ---- - -## Conference Talks & Webinars - -### "The Future of AL Development with AI" -**Event**: BC TechDays / Directions -**Speaker**: Industry Expert -**Duration**: ~45 minutes -**Level**: All - -**Topics**: -- Current state of AI assistance -- Emerging trends -- Impact on development teams -- Future predictions - -**Link**: [Example - Replace with actual link when available] - ---- - -### "Practical AI for BC Developers" Workshop -**Event**: Community Webinar -**Duration**: ~90 minutes -**Level**: Intermediate - -**Hands-On Workshop**: -- Interactive exercises -- Real-world scenarios -- Q&A session -- Best practices discussion - -**Link**: [Example - Replace with actual link when available] - ---- - -## Series & Playlists - -### "AI-Powered AL Development" Complete Course -**Creator**: Community Educator -**Videos**: 15 -**Total Duration**: ~6 hours -**Level**: Beginner to Advanced - -**Curriculum**: -1. Introduction and Setup (3 videos) -2. Basic Techniques (4 videos) -3. Advanced Patterns (4 videos) -4. Real Projects (3 videos) -5. Best Practices (1 video) - -**Link**: [Course playlist - Replace with actual link when available] - ---- - -### "Code Review with AI" Series -**Creator**: Community Contributor -**Videos**: 10 -**Duration**: ~20 minutes each -**Level**: Intermediate - -**Each Episode**: Reviews real AL code with AI assistance, showing improvements and best practices - -**Link**: [Series - Replace with actual link when available] - ---- - -## Live Streams & Recordings - -### Weekly AL Development with AI -**Stream**: Live on [Platform] -**Schedule**: Weekly -**Duration**: ~60 minutes -**Level**: All - -**Format**: -- Live coding with AI -- Community Q&A -- Tip sharing -- Problem solving - -**Link**: [Channel - Replace with actual link when available] - ---- +4. "Live Feature Build with AI Assistance" — community live stream + - Link: https://www.youtube.com/watch?v=SP1UJNjTN7s + - Quick: live coding session demonstrating end-to-end feature development with AI help ## How to Use These Videos -### For Learning -- **Beginners**: Start with "Getting Started" videos -- **Intermediate**: Focus on technique demonstrations -- **Advanced**: Watch real-world projects and case studies +- Start with the shorter discussion/intro videos to build context +- Watch demos and live coding to see practical workflows and gotchas +- Rewatch technical deep dives for specific patterns or tools -### For Reference -- Bookmark specific technique videos -- Use during development as guidance -- Share with team members -- Include in training materials +## Contribute a Video -### For Practice -- Code along with demonstrations -- Pause and try techniques yourself -- Apply patterns to your own projects -- Experiment with variations +If you've created a high-quality video about AI-assisted AL development, please contribute it. -## Creating Your Own Content +Submission checklist: +- Publicly accessible (YouTube, Vimeo, etc.) +- Focused on AL / Business Central development +- Provides clear, actionable content or valuable discussion -**Interested in creating AL + AI video content?** +How to submit: +1. Review the [Contributing](../../../contributing) guidelines +2. Open a pull request adding your video to this page +3. Provide: Title, Creator, Short Summary (1–2 lines), and Link -We encourage community members to create and share! +## Video Quality Criteria -**Tips for Creating Good Content**: -- Show real code and workflows -- Explain your thinking process -- Include mistakes and corrections -- Provide downloadable examples -- Keep audio quality high -- Use clear screen recordings - -**To Get Listed**: -1. Create quality content -2. Make it publicly accessible -3. Submit via [Contributing](../../../contributing) process - -## Video Quality Standards - -Listed videos meet these criteria: -- ✅ Clear audio and video -- ✅ Accurate information -- ✅ Relevant to AL/BC development -- ✅ Good demonstration quality -- ✅ Publicly accessible - -## Language & Accessibility - -Most videos are in English, but we welcome content in other languages. Please indicate language in submissions. - -**Accessibility**: -- Look for videos with closed captions -- Many creators provide transcripts -- Some include downloadable code samples - -## Updates - -**Latest Additions**: Check back regularly for new videos - -**To Suggest Videos**: See [Contributing](../../../contributing) section - ---- - -## Placeholder Notice - -> **Note to Contributors**: This page uses example placeholders for community video resources. As actual video content about AI-assisted AL development is published, it should be added here with proper attribution and links. Please contribute by submitting pull requests with real resources that meet the quality criteria above. +Videos listed here should meet these standards: +- Clear audio and video +- Accurate and relevant to AL development +- Demonstrates techniques, patterns, or practical workflows +- Publicly accessible --- ## Related Resources -- [Blog Posts & Articles](../articles) - Written content -- [Tools & Extensions](../tools) - Development utilities -- [Discussions](../discussions) - Community conversations -- [Getting Started](../../getting-started) - Foundational concepts +- [Blog Posts & Articles](../articles) +- [Tools & Extensions](../tools) +- [Discussions](../discussions)