Milestone.Types

An issue (ns/proj#N) or a merge request (ns/proj!N), the namespace possibly nested (package-setshaskellx#3). Built only by parseRef, makeRef, ref or a string literal, so a ref always names something a forge could hold. No record field: an update through one would skip the check.

Accepts exactly NS/PROJ#N and NS/PROJ!N: two or more /-separated names, the marker, and a positive number written without leading zeros, so every ref has one spelling.

The ref a string spells, as a string literal is: partial, an error on a string that is not a ref, so a program written without OverloadedStrings still fails as it is folded, not later.

The ref for a project path, a kind and a number, when they make one.

The project path, ns/proj or deeper.

What a ref points at: an issue (#) or a merge request (!).

The marker between a ref's project and its number.

A due date, a calendar date written YYYY-MM-DD. Built only by parseDue, due or a string literal, so the 30th of February cannot be due; no record field, for the reason Ref has none.

Accepts exactly the YYYY-MM-DD spellings of real dates, the 29th of February in leap years only.

The due date a string spells, as a string literal is: partial, an error on a string that is not a calendar date, as for ref.

A milestone's number, forge-wide.

A milestone as it crosses the wire. milestoneDone is the members that are done, so it is a subset of milestoneMembers; neither repeats a ref.

How far a milestone has got: tallyDone of its tallyTotal members are done. Counts rather than a ratio, so "none of three" and "no members" are different answers and a reader can print "2 of 5".