docs: update references to mason-org/mason.nvim (#1925)

williamboman · web-flow · commit 7c7318e8bae7 · 2025-05-06T23:30:27.000+02:00
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -2,5 +2,5 @@
 
 contact_links:
   - name: Ask a question about mason.nvim or get support
-    url: https://github.com/williamboman/mason.nvim/discussions/new?category=q-a
+    url: https://github.com/mason-org/mason.nvim/discussions/new?category=q-a
     about: Ask a question or request support for using mason.nvim
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yaml b/.github/ISSUE_TEMPLATE/feature_request.yaml
@@ -9,7 +9,7 @@ body:
     - type: checkboxes
       attributes:
           label: I've searched open issues for similar requests
-          description: If possible, please contribute to any [open issues](https://github.com/williamboman/mason.nvim/issues) instead of opening a new one.
+          description: If possible, please contribute to any [open issues](https://github.com/mason-org/mason.nvim/issues) instead of opening a new one.
           options:
               - label: "Yes"
 
diff --git a/.github/ISSUE_TEMPLATE/general_issue.yaml b/.github/ISSUE_TEMPLATE/general_issue.yaml
@@ -8,15 +8,15 @@ body:
           value: |
               # Issue reporting guidelines
 
-              1. This is not a general support board for package usage questions (e.g. "How do I do X?"). For questions, please refer to [the discussion board](https://github.com/williamboman/mason.nvim/discussions/categories/q-a) first! :)
+              1. This is not a general support board for package usage questions (e.g. "How do I do X?"). For questions, please refer to [the discussion board](https://github.com/mason-org/mason.nvim/discussions/categories/q-a) first! :)
               1. Before reporting an issue, make sure that you meet the minimum requirements mentioned in the README. Also review `:checkhealth mason` for potential problems.
 
               ---
 
     - type: checkboxes
       attributes:
           label: I've searched open issues for similar requests
-          description: If possible, please contribute to any [open issues](https://github.com/williamboman/mason.nvim/issues?q=is%3Aissue) instead of opening a new one.
+          description: If possible, please contribute to any [open issues](https://github.com/mason-org/mason.nvim/issues?q=is%3Aissue) instead of opening a new one.
           options:
               - label: "Yes"
 
diff --git a/.github/ISSUE_TEMPLATE/new_package_request.yaml b/.github/ISSUE_TEMPLATE/new_package_request.yaml
@@ -10,7 +10,7 @@ body:
     - type: checkboxes
       attributes:
           label: I've searched open & closed issues for similar requests
-          description: If possible, please contribute to [existing issues](https://github.com/williamboman/mason.nvim/issues?q=is%3Aissue+label%3Anew-package-request) instead of opening a new one.
+          description: If possible, please contribute to [existing issues](https://github.com/mason-org/mason.nvim/issues?q=is%3Aissue+label%3Anew-package-request) instead of opening a new one.
           options:
               - label: "Yes"
 
diff --git a/.github/ISSUE_TEMPLATE/package_installation_form.yaml b/.github/ISSUE_TEMPLATE/package_installation_form.yaml
@@ -19,7 +19,7 @@ body:
     - type: checkboxes
       attributes:
           label: I've searched open issues for similar requests
-          description: If possible, please contribute to any [open issues](https://github.com/williamboman/mason.nvim/issues?q=is%3Aissue+label%3Ainstallation-issue) instead of opening a new one.
+          description: If possible, please contribute to any [open issues](https://github.com/mason-org/mason.nvim/issues?q=is%3Aissue+label%3Ainstallation-issue) instead of opening a new one.
           options:
               - label: "Yes"
 
diff --git a/.github/ISSUE_TEMPLATE/package_issue.yaml b/.github/ISSUE_TEMPLATE/package_issue.yaml
@@ -11,7 +11,7 @@ body:
           value: |
               # Issue reporting guidelines
 
-              1. This is not a general support board for package usage questions (e.g. "How do I do X?"). For questions, please refer to [the discussion board](https://github.com/williamboman/mason.nvim/discussions/categories/q-a) first! :)
+              1. This is not a general support board for package usage questions (e.g. "How do I do X?"). For questions, please refer to [the discussion board](https://github.com/mason-org/mason.nvim/discussions/categories/q-a) first! :)
               1. Before reporting an issue, make sure that you meet the minimum requirements mentioned in the README. Also review `:checkhealth mason` for potential problems.
               1. General usage issues with packages should not be reported here. Please only report issues that you believe are a result of something that mason.nvim does.
               1. Please try to review errors yourself first and ensure it's not a problem that is local to your system only.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## [2.0.0](https://github.com/williamboman/mason.nvim/compare/v1.11.0...v2.0.0) (2025-05-06)
+## [2.0.0](https://github.com/mason-org/mason.nvim/compare/v1.11.0...v2.0.0) (2025-05-06)
 
 This release has been an ongoing effort for quite some time now and is now ready for release. Most users should not
 experience any breaking changes. If you use any of the Lua APIs that Mason provides you'll find an outline of the
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -42,7 +42,7 @@ make generate
 
 # Tests
 
-[Tests](https://github.com/williamboman/mason.nvim/tree/main/tests) MAY be added or modified to reflect any new changes.
+[Tests](https://github.com/mason-org/mason.nvim/tree/main/tests) MAY be added or modified to reflect any new changes.
 Tests can be executed on Unix systems like so:
 
 ```sh
diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 ![Linux](https://img.shields.io/badge/Linux-%23.svg?logo=linux&color=FCC624&logoColor=black)
 ![macOS](https://img.shields.io/badge/macOS-%23.svg?logo=apple&color=000000&logoColor=white)
 ![Windows](https://img.shields.io/badge/Windows-%23.svg?logo=windows&color=0078D6&logoColor=white)
-[![GitHub CI](https://github.com/williamboman/mason.nvim/workflows/Tests/badge.svg)](https://github.com/williamboman/mason.nvim/actions?query=workflow%3ATests+branch%3Amain+event%3Apush)
+[![GitHub CI](https://github.com/mason-org/mason.nvim/workflows/Tests/badge.svg)](https://github.com/mason-org/mason.nvim/actions?query=workflow%3ATests+branch%3Amain+event%3Apush)
 [![Sponsors](https://img.shields.io/github/sponsors/williamboman)](https://github.com/sponsors/williamboman)
 
 <img src="https://user-images.githubusercontent.com/6705160/177613416-0c0354d2-f431-40d8-87f0-21310f0bba0e.png" alt="mason.nvim" />
@@ -20,7 +20,6 @@
 # Table of Contents
 
 -   [Introduction](#introduction)
-    -   [How to use installed packages](#how-to-use-installed-packages)
 -   [Screenshots](#screenshots)
 -   [Requirements](#requirements)
 -   [Installation](#installation)
@@ -44,26 +43,6 @@ from Neovim builtins (shell, terminal, etc.) as well as other 3rd party plugins.
 
 For a list of all available packages, see <https://mason-registry.dev/registry/list>.
 
-## How to use installed packages
-
-> [`:h mason-how-to-use-packages`][help-mason-how-to-use-packages]
-
-Although many packages are perfectly usable out of the box through Neovim builtins, it is recommended to use other 3rd
-party plugins to further integrate these. The following plugins are recommended:
-
--   LSP: [`lspconfig`][lspconfig] & [`mason-lspconfig.nvim`][mason-lspconfig.nvim]
--   DAP: [`nvim-dap`][nvim-dap] & [`nvim-dap-ui`][nvim-dap-ui]
--   Linters: [`null-ls.nvim`][null-ls.nvim] or [`nvim-lint`][nvim-lint]
--   Formatters: [`null-ls.nvim`][null-ls.nvim] or [`formatter.nvim`][formatter.nvim]
-
-[formatter.nvim]: https://github.com/mhartington/formatter.nvim
-[lspconfig]: https://github.com/neovim/nvim-lspconfig
-[mason-lspconfig.nvim]: https://github.com/williamboman/mason-lspconfig.nvim
-[null-ls.nvim]: https://github.com/jose-elias-alvarez/null-ls.nvim
-[nvim-dap]: https://github.com/mfussenegger/nvim-dap
-[nvim-dap-ui]: https://github.com/rcarriga/nvim-dap-ui
-[nvim-lint]: https://github.com/mfussenegger/nvim-lint
-
 ## Screenshots
 
 |                                                                                                                                                        |                                                                                                                                                  |                                                                                                                                        |
@@ -112,22 +91,22 @@ your personal usage, some of these will also need to be installed. Refer to `:ch
 
 ```lua
 use {
-    "williamboman/mason.nvim"
+    "mason-org/mason.nvim"
 }
 ```
 
 ## [lazy.nvim](https://github.com/folke/lazy.nvim)
 
 ```lua
 {
-    "williamboman/mason.nvim"
+    "mason-org/mason.nvim"
 }
 ```
 
 ## [vim-plug](https://github.com/junegunn/vim-plug)
 
 ```vim
-Plug 'williamboman/mason.nvim'
+Plug 'mason-org/mason.nvim'
 ```
 
 # Setup
@@ -145,9 +124,9 @@ Refer to the [Configuration](#configuration) section for information about which
 
 ## Extensions
 
-Refer to the [Wiki](https://github.com/williamboman/mason.nvim/wiki/Extensions) for a list of 3rd party extensions.
+Refer to the [Wiki](https://github.com/mason-org/mason.nvim/wiki/Extensions) for a list of 3rd party extensions.
 
--   [`mason-lspconfig.nvim`](https://github.com/williamboman/mason-lspconfig.nvim) - recommended for usage with `lspconfig`
+-   [`mason-lspconfig.nvim`](https://github.com/mason-org/mason-lspconfig.nvim) - recommended for usage with `lspconfig`
 
 # Commands
 
@@ -344,7 +323,6 @@ local DEFAULT_SETTINGS = {
 </sup>
 
 [help-mason-commands]: ./doc/mason.txt#L178
-[help-mason-how-to-use-packages]: ./doc/mason.txt#L153
 [help-mason-introduction]: ./doc/mason.txt#L11
 [help-mason-quickstart]: ./doc/mason.txt#L67
 [help-mason-registry-refresh]: ./doc/mason.txt#L549
diff --git a/SECURITY.md b/SECURITY.md
@@ -6,4 +6,4 @@ Please report any suspected security vulnerabilities [here][new-advisory]. If th
 patch as soon as possible depending on complexity. Please follow [responsible disclosure
 practices](https://en.wikipedia.org/wiki/Coordinated_vulnerability_disclosure). Thanks!
 
-[new-advisory]: https://github.com/williamboman/mason.nvim/security/advisories/new
+[new-advisory]: https://github.com/mason-org/mason.nvim/security/advisories/new
diff --git a/doc/mason.txt b/doc/mason.txt
@@ -21,31 +21,6 @@ default. Executables are linked to a single `bin/` directory, which
 from Neovim builtins (shell, terminal, etc.) as well as other 3rd party
 plugins.
 
------------------
-MASON.NVIM LUA API
-                                                         *mason-api-reference*
-Mason offers a public Lua API that allows you to further customize or
-extend Mason. You may find documentation for it in the link below.
-
-https://github.com/williamboman/mason.nvim/blob/main/doc/reference.md
-
-Note ~
-    APIs not listed in the document are not considered public and are subject
-    to unannounced breaking changes.
-
------------------
-EXTENSION PLUGINS
-                                                            *mason-extensions*
-Extension plugins help fill gaps with the rest of the Neovim ecosystem.
-
-mason-lspconfig ~
-    `mason-lspconfig` bridges Mason with the `lspconfig` plugin - making
-    it easier to use both plugins together.
-    https://github.com/williamboman/mason-lspconfig.nvim
-
-3rd party extensions ~
-    https://github.com/williamboman/mason.nvim/wiki/Extensions
-
 ==============================================================================
 REQUIREMENTS                                              *mason-requirements*
 
@@ -106,9 +81,9 @@ finished installing:
     $ nvim --headless -c "MasonInstall lua-language-server rust-analyzer" -c qall
 <
 Note: ~
-    You may also use the Lua API |mason-api-reference| to programmatically
-    manage package installations. Through this interface you will also gain
-    access to more features to allow further customization.
+    You may also use Mason's Lua API to programmatically manage package
+    installations. Through this interface you will also gain access to more
+    features to allow further customization.
 
 -----------------
 THE MASON WINDOW
@@ -147,27 +122,14 @@ with registries appearing first in the list having precedence.
 HOW TO INSTALL PACKAGES                        *mason-how-to-install-packages*
 
 You may install packages either via the command interface or via Mason's Lua
-APIs. See |:MasonInstall| or |mason-api-reference| for more details.
+APIs. See |:MasonInstall| for more details.
 
 ==============================================================================
 HOW TO USE PACKAGES                                *mason-how-to-use-packages*
 
 Although many packages are perfectly usable out of the box through Neovim
 builtins, it is recommended to use other 3rd party plugins to further
-integrate these. The following plugins are recommended:
-
--   LSP: `lspconfig` & `mason-lspconfig.nvim`
--   DAP: `nvim-dap` & `nvim-dap-ui`
--   Linters: `null-ls.nvim` or `nvim-lint`
--   Formatters: `null-ls.nvim` or `formatter.nvim`
-
-formatter.nvim        https://github.com/mhartington/formatter.nvim
-lspconfig             https://github.com/neovim/nvim-lspconfig
-mason-lspconfig.nvim  https://github.com/williamboman/mason-lspconfig.nvim
-null-ls.nvim          https://github.com/jose-elias-alvarez/null-ls.nvim
-nvim-dap              https://github.com/mfussenegger/nvim-dap
-nvim-dap-ui           https://github.com/rcarriga/nvim-dap-ui
-nvim-lint             https://github.com/mfussenegger/nvim-lint
+integrate these.
 
 See also ~
     Execute external commands: |:!cmd|.
diff --git a/lua/mason-core/fetch.lua b/lua/mason-core/fetch.lua
@@ -8,7 +8,7 @@ local powershell = require "mason-core.installer.managers.powershell"
 local spawn = require "mason-core.spawn"
 local version = require "mason.version"
 
-local USER_AGENT = ("mason.nvim %s (+https://github.com/williamboman/mason.nvim)"):format(version.VERSION)
+local USER_AGENT = ("mason.nvim %s (+https://github.com/mason-org/mason.nvim)"):format(version.VERSION)
 
 local TIMEOUT_SECONDS = 30
 
diff --git a/lua/mason-core/fs.lua b/lua/mason-core/fs.lua
@@ -39,7 +39,7 @@ local function make_module(uv)
     function M.rmrf(path)
         assert(
             Path.is_subdirectory(settings.current.install_root_dir, path),
-            ("Refusing to rmrf %q which is outside of the allowed boundary %q. Please report this error at https://github.com/williamboman/mason.nvim/issues/new"):format(
+            ("Refusing to rmrf %q which is outside of the allowed boundary %q. Please report this error at https://github.com/mason-org/mason.nvim/issues/new"):format(
                 path,
                 settings.current.install_root_dir
             )
diff --git a/lua/mason-registry/api.lua b/lua/mason-registry/api.lua
@@ -3,7 +3,7 @@ local fetch = require "mason-core.fetch"
 
 local api = {}
 
--- https://github.com/williamboman/mason-registry-api
+-- https://github.com/mason-org/mason-registry-api
 local BASE_URL = "https://api.mason-registry.dev"
 
 local stringify_params = _.compose(_.join "&", _.map(_.join "="), _.sort_by(_.head), _.to_pairs)
diff --git a/lua/mason/health.lua b/lua/mason/health.lua
@@ -246,7 +246,7 @@ end
 ---@async
 local function check_mason()
     providers.github
-        .get_latest_release("williamboman/mason.nvim")
+        .get_latest_release("mason-org/mason.nvim")
         :on_success(
             ---@param latest_release GitHubRelease
             function(latest_release)
diff --git a/lua/mason/ui/components/header.lua b/lua/mason/ui/components/header.lua
@@ -29,7 +29,7 @@ return function(state)
                     p.highlight(settings.current.ui.keymaps.toggle_help),
                     p.none " for help",
                 }),
-                { p.Comment "https://github.com/williamboman/mason.nvim" },
+                { p.Comment "https://github.com/mason-org/mason.nvim" },
             },
         }),
         Ui.When(not state.info.registry_update.in_progress and #uninstalled_registries > 0, function()
diff --git a/lua/mason/ui/components/help/init.lua b/lua/mason/ui/components/help/init.lua
@@ -132,11 +132,11 @@ local function GenericHelp(state)
             Ui.HlTextNode {
                 {
                     p.none "- ",
-                    p.highlight "https://github.com/williamboman/mason.nvim/blob/main/CONTRIBUTING.md",
+                    p.highlight "https://github.com/mason-org/mason.nvim/blob/main/CONTRIBUTING.md",
                 },
                 {
                     p.none "- ",
-                    p.highlight "https://github.com/williamboman/mason.nvim/blob/main/doc/reference.md",
+                    p.highlight "https://github.com/mason-org/mason.nvim/blob/main/doc/reference.md",
                 },
             },
         }),
diff --git a/tests/mason-core/fetch_spec.lua b/tests/mason-core/fetch_spec.lua
@@ -30,7 +30,7 @@ describe("fetch", function()
         assert.spy(spawn.curl).was_called(1)
         assert.spy(spawn.wget).was_called_with {
             {
-                ("--header=User-Agent: mason.nvim %s (+https://github.com/williamboman/mason.nvim)"):format(
+                ("--header=User-Agent: mason.nvim %s (+https://github.com/mason-org/mason.nvim)"):format(
                     version.VERSION
                 ),
                 "--header=X-Custom-Header: here",
@@ -50,7 +50,7 @@ describe("fetch", function()
             match.same {
                 {
                     "-H",
-                    ("User-Agent: mason.nvim %s (+https://github.com/williamboman/mason.nvim)"):format(version.VERSION),
+                    ("User-Agent: mason.nvim %s (+https://github.com/mason-org/mason.nvim)"):format(version.VERSION),
                 },
                 {
                     "-H",
@@ -86,7 +86,7 @@ describe("fetch", function()
 
         assert.spy(spawn.wget).was_called_with {
             {
-                ("--header=User-Agent: mason.nvim %s (+https://github.com/williamboman/mason.nvim)"):format(
+                ("--header=User-Agent: mason.nvim %s (+https://github.com/mason-org/mason.nvim)"):format(
                     version.VERSION
                 ),
             },
@@ -105,7 +105,7 @@ describe("fetch", function()
             match.same {
                 {
                     "-H",
-                    ("User-Agent: mason.nvim %s (+https://github.com/williamboman/mason.nvim)"):format(version.VERSION),
+                    ("User-Agent: mason.nvim %s (+https://github.com/mason-org/mason.nvim)"):format(version.VERSION),
                 },
             },
             "-fsSL",
diff --git a/tests/mason-core/fs_spec.lua b/tests/mason-core/fs_spec.lua
@@ -14,7 +14,7 @@ describe("fs", function()
         end)
 
         assert.equals(
-            [[Refusing to rmrf "/thisisa/path" which is outside of the allowed boundary "/foo". Please report this error at https://github.com/williamboman/mason.nvim/issues/new]],
+            [[Refusing to rmrf "/thisisa/path" which is outside of the allowed boundary "/foo". Please report this error at https://github.com/mason-org/mason.nvim/issues/new]],
             e
         )
     end)
diff --git a/tests/mason-core/installer/managers/std_spec.lua b/tests/mason-core/installer/managers/std_spec.lua
@@ -141,7 +141,7 @@ describe("std clone", function()
     it("should clone", function()
         local ctx = test_helpers.create_context()
         ctx:execute(function()
-            std.clone "https://github.com/williamboman/mason.nvim"
+            std.clone "https://github.com/mason-org/mason.nvim"
         end)
 
         assert.spy(ctx.spawn.git).was_called(1)
@@ -150,15 +150,15 @@ describe("std clone", function()
             "--depth",
             "1",
             vim.NIL, -- recursive
-            "https://github.com/williamboman/mason.nvim",
+            "https://github.com/mason-org/mason.nvim",
             ".",
         }
     end)
 
     it("should clone and checkout rev", function()
         local ctx = test_helpers.create_context()
         ctx:execute(function()
-            std.clone("https://github.com/williamboman/mason.nvim", {
+            std.clone("https://github.com/mason-org/mason.nvim", {
                 rev = "e1fd03b1856cb5ad8425f49e18353dc524b02f91",
                 recursive = true,
             })
@@ -170,7 +170,7 @@ describe("std clone", function()
             "--depth",
             "1",
             "--recursive",
-            "https://github.com/williamboman/mason.nvim",
+            "https://github.com/mason-org/mason.nvim",
             ".",
         }
         assert
