SECURITY.md: replace the no-releases-yet note with a supported-versions table
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 2
- Forks
- 0
- Avg merge
- 2h 8m
- Merged PRs (30d)
- 49
Description
SECURITY.md currently says there is nothing to support yet:
markfluence has not had a release yet. Fixes land on
main, which is the only supported version until 1.0.0. This section will get a version table when there is something to put in it.
That is accurate today and becomes wrong the moment 1.0.0 is tagged, which is exactly when nobody is looking at the security policy. Tagging is the trigger for this one.
Replace the paragraph with the table GitHub's conventional policy uses — a version (or version range) column and a supported yes/no column. The thing to actually decide, rather than the table markup, is the support window: whether only the latest release gets fixes, or the current minor line does too. Given that this is a CLI with no plugin surface and no long-lived deployment to upgrade around, "latest release only" is probably right and is the cheapest promise to keep, but it should be a decision rather than a default that fell out of the template.
Two related things worth handling in the same change:
- The reporting section says disclosure is coordinated through a GitHub Security Advisory. Once there are releases, an advisory wants a fixed-in version, so the table and the advisory should agree about what a supported version means.
- The token-revocation note asserts that an Atlassian API token cannot be rotated in place and recovery means issuing a new one. That matches the scoped-token discussion in the README but was never verified against Atlassian's current UI. Worth confirming while editing the file.
Added in #94.
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.
Research direction
Start in SECURITY.md and read the scoped-token discussion in README. Decide and document the supported release window, replace the no-releases-yet paragraph with a version/support table, align the advisory guidance with that policy, and verify the Atlassian token-revocation note against the current UI.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github
- Domain
- documentation, security
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 65/100