Skip to content

docs: stop inviting outside plugin submissions in the README - #82

Merged
factory-ain3sh merged 1 commit into
masterfrom
ain3sh/readme-no-outside-contributions
Nov 5, 2026
Merged

factory-ain3sh merged 1 commit into
masterfrom
ain3sh/readme-no-outside-contributions

Conversation

@factory-droid

@factory-droid factory-droid Bot commented Nov 5, 2026

Copy link
Copy Markdown
Contributor

Description

What

The README no longer tells visitors to fork the repo and send their plugin as a PR. Its Contributing section now says outside PRs and plugin submissions are not accepted, points plugin authors at publishing their own marketplace (with links to the plugin docs), and sends bug reports to issues.

Why

The old four-step "fork, add under plugins/, edit marketplace.json, submit a PR" recipe reads as an open invitation. 30 of the 32 open PRs here come from outside Factory, all of them new plugin submissions, and none has a review.

How

The README states the policy and redirects authors to the docs, which already own the plugin format. The hand-maintained plugin-structure tree is gone; it duplicated Build a plugin. Two stale lines got fixed along the way: the intro no longer claims the marketplace ships droids, and core no longer claims to hold skills (#66 removed them).

Architecture

Where the README sends each visitor:

Visitor wants to Before After
Ship their own plugin Fork this repo, add it under plugins/, open a PR here Publish their own marketplace and add it with droid plugin marketplace add your-org/your-plugins. Outside PRs are not accepted.
Learn the plugin format Hand-maintained tree in the README Docs: #build-a-plugin, #marketplaces
Report a bug No route mentioned Open an issue
Install a Factory plugin Installation section Unchanged

Related Issue

None. Requested by @factory-ain3sh in Slack.

Reviewer Guide

Review depth: Skim. One file, copy only.
Read order: README.md, the Contributing section at the bottom.

Risk & Impact

Low. This changes docs only. No plugin, manifest, or marketplace entry changes.

Verification

Behavior verified @ b5bcd48: The #build-a-plugin and #marketplaces anchors exist on the live docs page. The issues link resolves because issues are enabled on this repo.
Not tested: N/A. There is no code path to exercise.
Standard validators: CI on this PR.

The Contributing section told visitors to fork the repo and send a PR
with their plugin, which drove a stream of third-party plugin PRs this
repository does not take. It now states that outside PRs and plugin
submissions are not accepted, points plugin authors at publishing their
own marketplace with links to the plugin docs, and sends bug reports to
issues. The duplicated plugin-structure tree goes too; the docs own that
format.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Co-authored-by: factory-ain3sh <ainesh@factory.ai>
@factory-ain3sh
factory-ain3sh merged commit e63e519 into master Nov 5, 2026
1 check passed
@factory-ain3sh
factory-ain3sh deleted the ain3sh/readme-no-outside-contributions branch November 5, 2026 10:13
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.

1 participant