Skip to content

IMP: skip private actions in describe_plugin - #20

Open
gregcaporaso wants to merge 2 commits into
devfrom
hide-hidden-actions
Open

IMP: skip private actions in describe_plugin#20
gregcaporaso wants to merge 2 commits into
devfrom
hide-hidden-actions

Conversation

@gregcaporaso

@gregcaporaso gregcaporaso commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Attempt to address #11. At present, hidden actions (i.e., those starting with _) are listed in the Plugin Overview documentation. For example, from here:

screenshot 2026-08-21 at 09 22 30

@ebolyen, do you know if this change will cover it? I'll work on some testing if you're not sure.

AI Disclosure

  • NO AI USED.
  • AI USED.

AI used in the second commit, primarily to review where additional edits were needed. The edit I made was just propagated to two other spots.

@github-project-automation github-project-automation Bot moved this to Backlog in 2026.10 🎃 Aug 21, 2026
@gregcaporaso gregcaporaso moved this from Backlog to Needs Review in 2026.10 🎃 Aug 21, 2026
@ebolyen ebolyen self-assigned this Aug 24, 2026
@ebolyen

ebolyen commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

I don't think this will work as you want, because the plugin page will still include those actions. I think we need a few updates here as well: https://github.com/rachis-org/rachis-doc/blob/105d82adc00f8f0d188bd2551bdc4e5a26b2b229/q2doc/common.py

Hidden actions (names starting with '_') were still emitted as their own pages in multi-page mode and as describe-action blocks in single-page mode, so they appeared in the docs despite being dropped from the Plugin Overview table in the previous commit. Skip them in both write_plugin loops, matching the describe_plugin change. Also adds the missing trailing newline.

@gregcaporaso requested the follow-up to @ebolyen's review comment on #20; Claude located the two loops, made the edits, and smoke-tested against the fondue plugin in the amplicon-docs environment.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@gregcaporaso

Copy link
Copy Markdown
Contributor Author

Thanks @ebolyen - I added the same logic in additional file you pointed me at. I did a test build and it seems to have worked. Is there anything you'd like me to check in particular? We could look at it together too if that's easier than doing a test build on your own.

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.

3 participants