Blog Post

The Skills Hub Blog
2 MIN READ

Changes to Microsoft Learn’s public documentation repositories

Martin-Ekuan's avatar
Martin-Ekuan
Icon for Microsoft rankMicrosoft
Sep 23, 2026

Microsoft Learn is changing how it manages public documentation repositories. Learn what the changes mean for GitHub contributors and where to continue sharing feedback.

 

If you contribute to Microsoft Learn documentation through GitHub, here’s what you need to know about upcoming changes to our public documentation repositories and what they mean for your contributions.

Over the coming months, Microsoft Learn will retire most public repositories associated with product documentation. As a guiding principle, documentation repositories associated with open-source products, projects, or communities are expected to remain open to public contributions. This change applies only to Microsoft Learn documentation repositories. It does not affect product source code repositories or sample code repositories.

Our goal is to maintain trusted, high-quality technical content for customers while establishing clearer criteria for when documentation repositories remain open to public contributions.

How repository retirement decisions will be made

Microsoft Learn will evaluate public documentation repositories based on several factors, including contribution activity, community engagement, business needs, and operational dependencies.

When a repository is approved for retirement, it will no longer be publicly accessible or visible. Members of the public will no longer be able to view Microsoft's repository history, pull requests, or issues. Personal forks will still be accessible.

What contributors can expect

For documentation repositories that remain open to external contributions, the contribution experience will not change. Contributors can continue using existing GitHub workflows to submit corrections, updates, and other improvements.

Before retiring a repository, Microsoft Learn will evaluate its open pull requests and GitHub issues through the existing process. Contributors with open contributions will receive repository-specific updates through GitHub comments.

Microsoft Learn has begun retiring public documentation repositories with smaller footprints and expects to retire the relevant repositories by the end of December 2026.

If you have an open contribution, watch the associated pull request or issue for updates.

How to continue sharing feedback

Community feedback remains an important part of improving Microsoft Learn documentation. If you want to provide documentation feedback after a repository retires, you can continue sharing questions and feedback through:

These channels provide ways to report documentation concerns, ask questions, and participate in technical community discussions after a public documentation repository has been retired.

Our continued commitment to the community

We sincerely thank everyone who has contributed to Microsoft Learn documentation. Community members have corrected errors, clarified technical concepts, suggested improvements, and made substantial content updates. These contributions have helped make Microsoft Learn documentation more accurate and useful for customers around the world.

Although the availability of some public documentation repositories is changing, our commitment to trusted, high-quality technical content and meaningful community feedback remains unchanged.

If you currently contribute through GitHub, continue following your open pull requests and issues for repository-specific notifications. You can also use Microsoft Q&A, feedback options on Microsoft Learn pages, and Microsoft community forums to continue sharing feedback.

Updated Sep 24, 2026
Version 3.0

12 Comments

Comments have been turned off for this post
  • Can’t agree more here with the rest!

    What is happening - this is a sad update to see, for osh there is offen I see stuff there is outdated- and I see that will keep going up then…

    I have updated a lot over the time, and I even got a lot into the docs for Global Secure Access of limitations for B2B scenarios, there was stuff never documented in the “faq”/“known limitations”… 🙄

    I still see one from the old old Azure AD times and almost before, screenshots and more - it’s impossible to hold up to date WITHOUT the community!

    • Martin-Ekuan's avatar
      Martin-Ekuan
      Icon for Microsoft rankMicrosoft

      Thank you for the updates you’ve contributed over time. I hear your concern that the remaining feedback channels may not provide the same effective path from identifying a problem to correcting the documentation. I’ll ensure that concern is shared with the team.

  • diecknet's avatar
    diecknet
    Iron Contributor

    In the past it was great that the community could improve the documentation, but the problems were obvious. Sometimes valuable community Pull Requests and Issues were left open for months or even years. Now that immediate cause for frustration will disappear, but with it we will also loose accountability, transparency and the chance for actual community involvement. 

    I don't like this change. But I'm not surprised.

    • Martin-Ekuan's avatar
      Martin-Ekuan
      Icon for Microsoft rankMicrosoft

      Thank you for the feedback. I understand this decision is unpopular.

  • dbird03's avatar
    dbird03
    Brass Contributor

    This is disappointing news. Microsoft stood out from others in the industry by using public repositories for their documentation. I remember contributing to an Exchange PowerShell cmdlet documentation years ago and thinking it was so cool that my changes were reflected in Microsoft’s official documentation for everyone to see. I hope Microsoft reconsiders this change and what it means for the community.

    • Martin-Ekuan's avatar
      Martin-Ekuan
      Icon for Microsoft rankMicrosoft

      I understand the disappointment. I agree that it was inspiring and somewhat magical to see public contributions reviewed, approved, and published.

  • Ryan Yates's avatar
    Ryan Yates
    Brass Contributor

    This is a rather unfortunate & silly decision & whilst I really wanna leverage certain words here that are in the English Language, I will refrain from doing so to keep somewhat professional, what I say elsewhere well that's a different matter.

    One of the best things that Microsoft did was open sourcing their documentation, even for closed source products like the on-premises versions of M365 Servers & fully integrating the process for making edits to individual documents available in the pages themselves. The removal of that feature was a mistake, the removal of these repositories for currently supported closed source products is also a mistake, like it has been for deleting repositories for all those out of support/deprecated products that are still deployed out there in the world.

    From a historian's point of view I cannot understand why this change is happening, the only place that to me makes sense is that there is a need to free up some of the compute resources that are currently allocated for these repositories and reshuffle things after recent layoffs.

    Doing this feels akin to .NET yelling out to the community "Hey we going back closed source now sorry & all the documentation is also going behind closed doors too & will need a product license to access"

    That is not a suggestion either. But you get why this feels kinda like a sneaky stab in the back when we've been unfortunately stunned when someone threw a stun grenade our way.

    The options for feedback just unfortunately don't meet the need for the end to end of what is a `living breathing document` which the GitHub backed repos does best. 

    I mean you even still today have a Learn Pathway for becoming a Learn Documentation Contributor - https://learn.microsoft.com/en-us/training/modules/become-learn-contributor/?source=recommendations


    Honestly, as one of the many former MVP's for 7 years & a currently serving Microsoft Global Community Initiative Regional Lead (MGCI RL) I am very disappointed in seeing the demise of all of Microsoft's documentation being open source editable, with full end to end traceability as to when and why edits are being made.

    I already know from the chatter on Twitter/X about this, which is how I learned about it that this decision, is not being met with "warm fuzzy feelings" in the slightest.

    I hope that perhaps there will be either a rethink, or a more detailed reasoning as to why this decision was made as this post, as to be brutally honest whilst still being professionally kind, we need actual details being provided as this post lacks the detail and just adds unnecessary scare by being so light on the details.

    At a minimum, we should have had some detail that covers
    - How many repositories are potentially affected with a list of them & importantly who's the owner of that repo/group of repos.

    • I'd recommend a public tracking system that is built and viewable on GitHub because well it would just make sense

    - Additional data around the operating costs for individual repos 

    • Human and compute cost
    • I'd quite like this to be information that is available via repositories themselves as that information is already available somewhere even if in multiple disparate systems and hidden by "Promotional Credits" costs for any of the agent costs etc

    There are estimate tools out there but we should really be able to see what the rough monthly cost of a repo is. Which I know isn't just for these repos but that info, would help people actually understand decisions like this instead of it just being a "hidden management only thing" and better brings things into the open.

    But ya, I'm not a fan of this direction, at all.

    • Martin-Ekuan's avatar
      Martin-Ekuan
      Icon for Microsoft rankMicrosoft

      Ryan, thank you for taking the time to explain your concerns. This was not an easy decision.

      To clarify, the published documentation will remain publicly accessible on Microsoft Learn, and this change does not apply to product source-code or sample-code repositories. Some documentation repositories associated with open-source products, projects, or active communities are also expected to remain open.

  • MartinHimken's avatar
    MartinHimken
    Brass Contributor

    John said it almost perfectly in their answer - I really just want to add, that as MVP, I also feel this is a step in the wrong direction. 

    The main point John made that I want to reiterate is that quality is determined by contributions. AI alone cannot understand certain nuances. In fact, quite the opposite is true: AI uses this documentation as a source of truth. Don't create an Ouroboros of learning that feeds on itself.

    • Martin-Ekuan's avatar
      Martin-Ekuan
      Icon for Microsoft rankMicrosoft

      Martin, thank you for sharing your perspective and for your contributions as an MVP. Human expertise and community input remain vital to documentation quality, especially for nuance, edge cases, and real-world implementation. We are exploring more sustainable ways to gather and incorporate this insight.

  • John Flores's avatar
    John Flores
    Brass Contributor

    Martin, I genuinely don’t understand how Microsoft can claim a continued commitment to high-quality technical content while simultaneously removing public contribution mechanisms and after laying off much of the technical writing organization.

    I’ll acknowledge that some PRs were junk, and some GitHub issues were little more than support tickets in disguise. Anyone who worked in those repositories knows there was plenty of noise to sift through.

    But let’s also be honest about the alternative. The documentation feedback control on Learn is effectively a black hole. Customers submit feedback and rarely know whether anyone saw it, understood it, acted on it, or simply closed it. GitHub wasn’t perfect, but it provided transparency, accountability, and a visible path from problem to resolution.

    I say this as someone who spent nine and a half years as a technical writer at Microsoft, working on this content. I wasn’t an outside observer. I was one of the people creating, reviewing, and maintaining the documentation customers relied on.

    The hardest documentation problems were never about generating more words. They were about answering the questions customers actually have:

    • How does this change affect my existing deployment?

    • What breaks when I migrate?

    • Which authentication methods are impacted?

    • What are the edge cases?

    Those answers came from experienced writers partnering with engineering teams, challenging assumptions, finding gaps, and translating product knowledge into something customers could actually understand.

    Community contributions helped close those gaps. I was one of the people who wanted to continue helping. Now public repositories are going away, the writing organization is dramatically smaller, and one of the few transparent feedback loops is disappearing.

    Community contributions weren’t valuable because every contribution was good. They were valuable because the process was open.

    I sincerely hope I’m wrong, but from where I sit, this feels less like an investment in documentation quality and more like a reduction in the people and processes that made that quality possible.

    • Martin-Ekuan's avatar
      Martin-Ekuan
      Icon for Microsoft rankMicrosoft

      John, thank you for laying this out so thoughtfully and for the many years you spent working on our docs. Your concerns about transparency, accountability, repository history, and the effectiveness of alternative feedback channels are fair.

      This change isn’t a reflection of the value of community contributions. Some repositories associated with open-source products, projects, or active communities are expected to remain open, and existing pull requests and issues will be evaluated before affected repositories are retired.