Fix misleading `list-dids` example and clarify default `FILE` exclusion
@voetberg is already working on this.
Since Sep 1, 2026.
- Dominant language
- Python
- Stars
- 4
- Forks
- 71
- Avg merge
- 2d 1h
- Merged PRs (30d)
- 11
Description
Description
The current documentation for "Querying DIDs" contains an incorrect example that shows FILE DIDs being returned by default. In reality, rucio list-dids only returns collections (DATASET/CONTAINER) unless filtered.
The Error
The docs currently show:
$ rucio list-dids user.jdoe:*
# ... table shows FILE types here (This is incorrect behavior)
The Fix
- Update the example: Remove the FILE entries from the default output table or update the command to include --filter type=FILE.
- Add a Note: Explicitly state that files are excluded by default for scalability/performance reasons.
Context
This stems from the discussion in rucio/rucio issue rucio/rucio#8519.
AI Disclosure
In accordance with the Rucio AI Policy, I disclose that this issue was drafted with the assistance of an AI tool. I have reviewed the technical details (referencing issue rucio/rucio#8519 and the current documentation) and confirm that I fully understand the proposed changes and the discrepancy being reported.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.