Skip to content

docs: explain plugin installs from pre-release-only repositories - #156

Merged
dlotterman merged 1 commit into
mainfrom
dlott_plugins-prerelease
Nov 12, 2026
Merged

dlotterman merged 1 commit into
mainfrom
dlott_plugins-prerelease

Conversation

@dlotterman

@dlotterman dlotterman commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Replaces #145, which can't be merged as is.

Changes

  • Building plugins: tag releases with a semantic version such as v1.2.3 or v1.2.3-rc.1. If only pre-releases exist, datumctl installs the highest pre-release tag.
  • Using plugins: without a version, datumctl installs the release GitHub marks as latest. If the repository has only pre-releases, it installs the highest pre-release, and datumctl plugin upgrade follows newer pre-releases.

Based on datum-cloud/datumctl#361.

Repair of using-plugins.mdx

On main, datumctl/plugins/using-plugins.mdx has ended in 852 NUL bytes and a duplicated "Contexts & scoping" line since a70ea1f. Git treats the page as binary, so GitHub shows its diffs as empty and Vale skips it. A merge from main on #145 then emptied the page completely.

This PR removes the corrupted tail. Apart from the new paragraph, the page matches main. Once merged, git reads the page as text again. Vale may then annotate words already on the page, such as "untrusted".

Test plan

  • No NUL bytes remain in the page.
  • Both pages compile as MDX.
  • Vale shows no new findings in the added lines.

@mintlify

mintlify Bot commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Datum 🟢 Ready View Preview Nov 12, 2026, 4:05 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

Explain that installing a plugin from a GitHub repository with only
pre-releases installs the highest pre-release, and which tag formats plugin
authors should use. Based on datum-cloud/datumctl#361. Replaces #145.

Also repair datumctl/plugins/using-plugins.mdx: since a70ea1f the page has
ended in 852 NUL bytes and a duplicated "Contexts & scoping" line, so git
treats it as binary and reviews show no diff.
@dlotterman
dlotterman force-pushed the dlott_plugins-prerelease branch from bcdbbf5 to 1e32a39 Compare November 12, 2026 16:05
@dlotterman
dlotterman merged commit 1406b8a into main Nov 12, 2026
4 of 5 checks passed
@dlotterman
dlotterman deleted the dlott_plugins-prerelease branch November 12, 2026 16:06

This branch was successfully deployed

1 active deployment
staging — 1e32a39a Deployed Nov 12, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants