Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -734,6 +734,19 @@ triaged, every issue is on one, and the milestone says what kind of change it is
A Goal with no last piece to aim at is on Guiding principles
([#1511](https://github.com/asc-community/AngouriMath/pull/1511#issuecomment-5858231058)).
- A proposal without `Accepted` is on Future until it is decided: a version would decide it.
- **A parent is never due before its children.** Milestones run through the versions in order,
then Future, then Guiding principles, and a parent issue's is never earlier than any child's:
when a child moves later than its parent, the parent moves with it
([#718](https://github.com/asc-community/AngouriMath/issues/718#issuecomment-5910345918)). The
rule runs one way. Bringing work *earlier* is a scheduling decision, not a consequence of it:
the integration work under #233 goes to `2.6.0` because calculus comes first, being the
door to university mathematics and beyond
([#1626](https://github.com/asc-community/AngouriMath/pull/1626#issuecomment-5911144638)), and
#718, a parent with no last piece to aim at, is on Guiding principles. And "under" is
GitHub's sub-issue relationship, not prose: an issue that belongs under another is linked in the
turn it is filed, and a comment says "under" only once the link is there
([#718](https://github.com/asc-community/AngouriMath/issues/718#issuecomment-5910315961)) --
the tree is what the backlog is read by, and a word in a comment is invisible to it.

An issue you open has its type and its milestone from the moment it is filed, which the reply
that triages someone else's issue does for theirs. `gh issue create --milestone` sets the one;
Expand All @@ -743,6 +756,13 @@ the type needs a second call, since `gh issue create` has no flag for it:
gh api -X PATCH repos/asc-community/AngouriMath/issues/<n> -f type=Bug # Bug, Feature, Maintenance or Goal
```

and a sub-issue link takes the child's id rather than its number:

```
gh api -X POST repos/asc-community/AngouriMath/issues/<parent>/sub_issues \
-F sub_issue_id=$(gh api repos/asc-community/AngouriMath/issues/<child> --jq .id)
```

When a PR merges, check its issue's milestone still describes where the change lands — a fix
that turned out breaking moves to the major, with a `BREAKING-CHANGES.md` entry. Release
clearance is the milestone read through: every open item on it either ships in this release or is
Expand Down
Loading