Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Shorten and simplify clause 5 discovery

Open Beginner friendly
  • Is something wrong?
#392 1 comment 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@oej is already working on this.

Since Oct 7, 2026.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
68/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Domain
documentation

Research direction

Start with Clause 5, Discovery, in the specification and compare its three TEA discovery subclauses. Remove repeated non-normative prose while preserving the content; done means the clause communicates the same information with only the necessary text.

Written by the indexing model from the issue text.

Description

TEI Discovery

Clause 5 Discovery repeats itself, which reduces clarity instead of contributing to it. For example, the clause defines TEA discovery three different times in three different subclauses

Reduce the non-normative prose to the absolute minimum amount of text to communicate the content.

Dominant language
Shell
Stars
120
Forks
24
Avg merge
1d 6h
Merged PRs (30d)
67

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from CycloneDX/transparency-exchange-api

All issues in CycloneDX/transparency-exchange-api

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.