Skip to content

docs: soften README contribution guidance #33

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mindpower merged 1 commit into from
Jun 21, 2026
Merged

docs: soften README contribution guidance #33

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 18 additions & 8 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,5 @@
# Agentic Resource Discovery (ARD)

> **Proposing a change to the specification?** Please
> [open an issue](https://github.com/ards-project/ard-spec/issues/new) to start a
> discussion first. The spec is maintained by its authors, and changes to it are
> made by the maintainers once a proposal is agreed. Pull requests that modify the
> specification will generally be closed in favor of that discussion. Issues,
> questions, and feedback are always welcome.

Canonical home of the **Agentic Resource Discovery** specification — a federated,
domain-anchored standard for cataloging, searching, and discovering agentic
resources (MCP servers, A2A agent cards, Skills, APIs, and other callable
Expand All @@ -25,10 +18,27 @@ this is the single source of truth.
- [`adr/`](adr/) — architecture decision records
- [`conformance/`](conformance/) — conformance test tooling

## Contributing

We'd love your involvement — contributions and feedback are very welcome. To keep
the standard coherent, we handle two kinds of changes differently:

- **Normative spec changes** (anything that alters the standard itself —
[`spec/ard.md`](spec/ard.md) and the schemas in [`spec/schemas/`](spec/schemas/)):
please [open an issue](https://github.com/ards-project/ard-spec/issues/new) to
discuss the proposal first. Once there's agreement, a maintainer lands the change.
This keeps the spec consistent and gives every change a clear rationale on record.
- **Everything else** (examples, conformance tooling, reference implementations,
documentation, typo and link fixes): **pull requests are welcome** — just open one.

Not sure which bucket your idea falls in? Open an issue and we'll figure it out
together.

## Status

**v0.9 (Draft).** The specification is open and evolving; feedback and proposals
are welcome via [issues](https://github.com/ards-project/ard-spec/issues).
are welcome via [issues](https://github.com/ards-project/ard-spec/issues) and,
for non-normative changes, [pull requests](https://github.com/ards-project/ard-spec/pulls).

## License

Expand Down
Loading