Skip to content

Keep Authors and Instruments first in the plugin README - #67

Merged
seb5g merged 2 commits into
5.3.xfrom
docs/agents-readme-order
Nov 4, 2026
Merged

seb5g merged 2 commits into
5.3.xfrom
docs/agents-readme-order

Conversation

@seb5g

@seb5g seb5g commented Nov 4, 2026

Copy link
Copy Markdown
Contributor

Before: AGENTS.md says nothing about the order of the sections of a plugin README, and the README of the template itself has a "Development" section before "Authors". A plugin README written from it, or by an assistant adding requirements or notes at the top, breaks the way pymodaq_plugin_manager reads it.

After: the "Done checklist" of AGENTS.md states the order (a short description, Authors, Contributors if needed, Instruments) and that nothing else goes before these sections or between them: requirements, installation, hardware notes or differences with another branch come after the Instruments list. The "Development" section of the template README moves after the "Installation instructions" at the end.

How: the rule comes from extract_authors_from_description in pymodaq_plugin_manager/validate.py (1.3.8): it starts at Authors and stops at Contributors or Instruments. Documentation change only; the README still builds as before (no code touched). Found while updating the README of pymodaq_plugins_daqmx (#19, #20).


Generated by Claude Code

pymodaq_plugin_manager reads the README in that order.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Tdiso1u1ZhikSutj2Qs5Cg
Authors and Instruments must come first: the plugin manager reads the README in that order.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Tdiso1u1ZhikSutj2Qs5Cg
@seb5g
seb5g merged commit 0816172 into 5.3.x Nov 4, 2026
8 checks passed
@seb5g
seb5g deleted the docs/agents-readme-order branch November 4, 2026 16:49
This was referenced Nov 4, 2026
This was referenced Nov 4, 2026
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