--- id: video/mnxOSl1Y9PI type: video title: "What's New: Key Updates in our Learning Content (documentation) For Developers (2024 release wave 1)" summary: Business Central developer documentation updates for 2024 release wave 1, reached through aka.ms/BC developer. New or reworked sections cover data analytics, reporting and word layouts, error handling, troubleshooting, background processing, telemetry, security, extensibility, and contributing to docs. tier: official language: en tags: - documentation updates - al language - data analytics - reporting - error handling - troubleshooting - background processing - telemetry - security - extensibility - word layouts system: development review: state: reviewed by: opus at: "2026-10-07T23:09:23.298Z" flags: [] generated: at: "2026-10-07T23:09:23.341Z" pipeline: 0.2.0 prompts: extract-video: 1 summarize-video: 2 input_hash: 80993968b6b510db8c57f960fb4538231e2b35b1cadb53d6ce279a32ab0e1cb0 evidence: - kind: video url: https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=44s title: "What's New: Key Updates in our Learning Content (documentation) For Developers (2024 release wave 1)" date: "2024-04-04T13:30:30.000Z" commit: null t: 44 quote: the new AKA link aka.ms slbc developer takes you to this session section - kind: video url: https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=105s title: "What's New: Key Updates in our Learning Content (documentation) For Developers (2024 release wave 1)" date: "2024-04-04T13:30:30.000Z" commit: null t: 105 quote: programming in the AL language is a list of sections that describe how to do various things - kind: video url: https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=147s title: "What's New: Key Updates in our Learning Content (documentation) For Developers (2024 release wave 1)" date: "2024-04-04T13:30:30.000Z" commit: null t: 147 quote: analytics is no no longer just write a report and give it to the customer there are many different artifacts in analytics - kind: video url: https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=244s title: "What's New: Key Updates in our Learning Content (documentation) For Developers (2024 release wave 1)" date: "2024-04-04T13:30:30.000Z" commit: null t: 244 quote: word layouts also got a huge over overhaul in documentation - kind: video url: https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=298s title: "What's New: Key Updates in our Learning Content (documentation) For Developers (2024 release wave 1)" date: "2024-04-04T13:30:30.000Z" commit: null t: 298 quote: for stability is error handling and uh for error handling we also added a new section - kind: video url: https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=440s title: "What's New: Key Updates in our Learning Content (documentation) For Developers (2024 release wave 1)" date: "2024-04-04T13:30:30.000Z" commit: null t: 440 quote: Telemetry is not only for people in the basement is also a tool for you as a developer - kind: video url: https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=481s title: "What's New: Key Updates in our Learning Content (documentation) For Developers (2024 release wave 1)" date: "2024-04-04T13:30:30.000Z" commit: null t: 481 quote: security is not only for the admin it's also for you as developer you need to think security into your app - kind: video url: https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=591s title: "What's New: Key Updates in our Learning Content (documentation) For Developers (2024 release wave 1)" date: "2024-04-04T13:30:30.000Z" commit: null t: 591 quote: the way to get started is simply to search in in docs for contribute links: learn: [] objects: [] features: [] topics: [] localizations: [] videos: [] posts: [] guidelines: [] video_id: mnxOSl1Y9PI channel: yt-microsoft source_name: Microsoft Dynamics 365 Business Central (YouTube) url: https://www.youtube.com/watch?v=mnxOSl1Y9PI published_at: "2024-04-04T13:30:30.000Z" duration_s: 785 captions: full audience: - developer - functional consultant - partner chapters: - t: 0 title: New Developer Documentation Overview and AKA Link - t: 64 title: "Documentation Structure: Getting Started and AL Programming" - t: 147 title: Data Analytics and Reporting for Developers - t: 201 title: "Reporting Documentation: Reports and Word Layouts" - t: 298 title: Error Handling and Troubleshooting Guides - t: 397 title: Background Processing and Telemetry for Developers - t: 481 title: Security and Extensibility Documentation - t: 571 title: Contributing to Documentation and Getting Started - t: 691 title: Related Sessions and Resources features: - name: New Developer Documentation Overview status: unclear t: 16 verified: false status_source: video - name: Data Analytics for Developers status: unclear t: 147 verified: false status_source: video - name: Reporting Documentation Overhaul status: unclear t: 201 verified: false status_source: video - name: Word Layouts Documentation status: unclear t: 244 verified: false status_source: video - name: Error Handling Documentation status: unclear t: 298 verified: false status_source: video - name: Troubleshooting Guides and Tools status: unclear t: 355 verified: false status_source: video - name: Background Processing Documentation status: unclear t: 397 verified: false status_source: video - name: Telemetry for AL Developers status: unclear t: 440 verified: false status_source: video - name: Security for Developers status: unclear t: 481 verified: false status_source: video - name: Extensibility Overview Documentation status: unclear t: 514 verified: false status_source: video - name: Documentation Contribution Process status: unclear t: 571 verified: false status_source: video objects_mentioned: [] quotes: - t: 44 text: the new AKA link aka.ms slbc developer takes you to this session section check: exact - t: 105 text: programming in the AL language is a list of sections that describe how to do various things check: exact - t: 147 text: analytics is no no longer just write a report and give it to the customer there are many different artifacts in analytics check: snapped - t: 244 text: word layouts also got a huge over overhaul in documentation check: exact - t: 298 text: for stability is error handling and uh for error handling we also added a new section check: exact - t: 440 text: Telemetry is not only for people in the basement is also a tool for you as a developer check: exact - t: 481 text: security is not only for the admin it's also for you as developer you need to think security into your app check: exact - t: 591 text: the way to get started is simply to search in in docs for contribute check: exact --- # What's New: Key Updates in our Learning Content (documentation) For Developers (2024 release wave 1) > Business Central developer documentation updates for 2024 release wave 1, reached through aka.ms/BC developer. New or reworked sections cover data analytics, reporting and word layouts, error handling, troubleshooting, background processing, telemetry, security, extensibility, and contributing to docs. [Watch on YouTube](https://www.youtube.com/watch?v=mnxOSl1Y9PI) · Microsoft Dynamics 365 Business Central (YouTube) · 2024-04-04 · 13:05 · tier official · reviewed (checked by Opus) ## Overview The video walks through the restructured developer documentation for Business Central, now centralized behind the aka.ms/BC developer link. It describes the layout of the getting started and AL programming sections, then goes through the areas that were added or rewritten in this wave. Reporting and word layouts were reworked, including guidance on designing datasets for word layouts and moving from RDL. New material covers error handling, troubleshooting tools and guides, background processing, telemetry for AL developers, security for developers, and extensibility. The video ends with how to contribute to the docs through GitHub pull requests. ## Key points - aka.ms/BC developer is the entry link to the central developer documentation, with getting started, programming in AL, and AL programming language sections. - A new data analytics section explains the analytics artifacts available to developers (queries, data analysis on lists or queries, Power BI reports, Excel layout reports) and when to use each. - Reporting documentation got a major rewrite, and a new word layouts article covers dataset design, layout design, and moving from RDL to Word layouts for document reports. - A new error handling section covers reasoning about errors, failure modeling, robust coding, error dialogs and stack traces, actionable errors, and meaningful error messages. - A troubleshooting overview lists the available troubleshooting tools and new troubleshooting guides (TSGs) in many areas. - A new overview on running things in the background covers new sessions, page background tasks, task scheduler, and job queue, and how they differ, to improve perceived performance. - Telemetry docs for AL developers add content on telemetry scope and on the feature telemetry module in the system application. ## Chapters - [0:00](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=0s) New Developer Documentation Overview and AKA Link - [1:04](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=64s) Documentation Structure: Getting Started and AL Programming - [2:27](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=147s) Data Analytics and Reporting for Developers - [3:21](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=201s) Reporting Documentation: Reports and Word Layouts - [4:58](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=298s) Error Handling and Troubleshooting Guides - [6:37](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=397s) Background Processing and Telemetry for Developers - [8:01](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=481s) Security and Extensibility Documentation - [9:31](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=571s) Contributing to Documentation and Getting Started - [11:31](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=691s) Related Sessions and Resources ## Features | Feature | Status | At | |---|---|---| | New Developer Documentation Overview | status not stated, demoed | [0:16](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=16s) | | Data Analytics for Developers | status not stated | [2:27](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=147s) | | Reporting Documentation Overhaul | status not stated | [3:21](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=201s) | | Word Layouts Documentation | status not stated | [4:04](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=244s) | | Error Handling Documentation | status not stated | [4:58](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=298s) | | Troubleshooting Guides and Tools | status not stated | [5:55](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=355s) | | Background Processing Documentation | status not stated | [6:37](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=397s) | | Telemetry for AL Developers | status not stated | [7:20](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=440s) | | Security for Developers | status not stated | [8:01](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=481s) | | Extensibility Overview Documentation | status not stated | [8:34](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=514s) | | Documentation Contribution Process | status not stated | [9:31](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=571s) | ## Quotes - [0:44](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=44s) "the new AKA link aka.ms slbc developer takes you to this session section" - [1:45](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=105s) "programming in the AL language is a list of sections that describe how to do various things" - [2:27](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=147s) "analytics is no no longer just write a report and give it to the customer there are many different artifacts in analytics" - [4:04](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=244s) "word layouts also got a huge over overhaul in documentation" - [4:58](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=298s) "for stability is error handling and uh for error handling we also added a new section" - [7:20](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=440s) "Telemetry is not only for people in the basement is also a tool for you as a developer" - [8:01](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=481s) "security is not only for the admin it's also for you as developer you need to think security into your app" - [9:51](https://www.youtube.com/watch?v=mnxOSl1Y9PI&t=591s) "the way to get started is simply to search in in docs for contribute"