Skip to content

docs: prefer clean reinstall guidance for install command collisions#149

Merged
blindzero merged 2 commits intomainfrom
codex/fix-idle-module-install-error
Feb 8, 2026
Merged

docs: prefer clean reinstall guidance for install command collisions#149
blindzero merged 2 commits intomainfrom
codex/fix-idle-module-install-error

Conversation

@blindzero
Copy link
Copy Markdown
Owner

Motivation

  • Avoid recommending -AllowClobber for Install-Module because it can cause unexpected behavior; prefer guiding users to perform a clean reinstall when command name collisions occur.

Description

  • Replaced the previous -AllowClobber recommendation in docs/use/installation.md with a Docusaurus callout (:::info) that instructs users to run Get-InstalledModule IdLE, IdLE.Core -ErrorAction SilentlyContinue | Uninstall-Module -AllVersions -Force followed by Install-Module -Name IdLE -Scope CurrentUser -Force as the preferred remediation for command collisions.

Testing

  • No automated tests were required for this documentation-only change; the update was validated by inspecting the modified markdown and committing the change.

Codex Task

Copilot AI review requested due to automatic review settings February 8, 2026 10:22
@blindzero blindzero self-assigned this Feb 8, 2026
@blindzero blindzero added the type:docs Improvements or additions to documentation. label Feb 8, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates IdLE’s installation documentation to steer users away from Install-Module -AllowClobber when PowerShellGet reports command-name collisions, and instead recommend a clean reinstall flow.

Changes:

  • Replaces the prior -AllowClobber guidance with a Docusaurus :::info callout for command-collision remediation.
  • Adds uninstall/reinstall commands intended to resolve collision scenarios by removing existing IdLE installs before reinstalling.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings February 8, 2026 10:33
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

@blindzero blindzero merged commit 93db885 into main Feb 8, 2026
14 checks passed
@blindzero blindzero deleted the codex/fix-idle-module-install-error branch February 9, 2026 22:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

codex type:docs Improvements or additions to documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants