
Maintenance
Part of 5 things to check in community platforms
How to track community platforms updates without missing a policy change
Track community platforms updates with six dated documents, a normalized policy diff, and a three-bin triage process that keeps every entry readable.
A community platform rarely announces the change that matters. The announcement covers a new feature. The real change sits in the third paragraph of a revised terms page, in a help article that lost a sentence, or in a release list nobody read.
Catching it is a watching job: a fixed set of documents, fetched on a schedule, plus a way of reading a difference.
What to take away
- Keep dated copies of six documents per platform. The diff between copies is the only reliable change detector.
- Read a policy diff for moved obligations, not moved paragraphs. Most revisions rearrange; the few that matter add a right for the operator or remove one for the member.
- Sort every finding into field change, context change, or noise before editing the entry.
- Fetch quarterly for hosted platforms, monthly for self-hosted release lists. A paused cadence is only visible against time.
- Log every fetch, including the ones that found nothing.
The six documents worth saving
Six documents, saved with the date each is fetched.
Six documents to save
Document
- Terms of service
- Operator rights over content
- Privacy policy
- Collected and shared data
- Organizer pricing page
- Paid gates on capabilities
- Help articles
- Export, deletion, transfer, moderation
- Release notes
- Maintenance, license, breaking changes
- Status page
- Reliability and honesty
What can change
- Terms of service
- Occasionally, stated date
- Privacy policy
- Often, sometimes silently
- Organizer pricing page
- Often, never announced
- Help articles
- Silently, undated
- Release notes
- Cadence itself informative
- Status page
- Continuously
How often it moves
- Terms of service
- Privacy policy
- Organizer pricing page
- Help articles
- Release notes
- Status page
- Terms of service.Who may do what, on what notice, and under which jurisdiction.
- Privacy policy.What is collected, how long it is kept, and who it is shared with.
- Acceptable use policy.What the operator may remove, and on what grounds.
- Help articles on export and deletion.The steps and limits that decide whether members can leave with their data.
- The release list or change log.For self-hosted software, the dated record of what shipped.
- The license file.What an organizer may run, modify, and redistribute.
Blog posts, social announcements and feature tours are prompts to check the six. They are not sources in themselves.
Diffing a policy without being fooled
Policy revisions are mostly restructuring: sections renumbered, headings renamed, sentences reordered. A raw diff shows hundreds of changed lines and buries the three that matter.
Normalize before diffing
- Strip numbering from sections
- Collapse whitespace
- Sort sections by heading
- Diff the normalized text
- Read for verbsmay, must, retained, receives
Normalize before diffing. Strip numbering, collapse whitespace, and sort sections by heading where you can, so a moved section does not read as a deletion plus an insertion. The tools are ordinary. The discipline is doing it every time.
| Raw diff line | After normalization |
|---|---|
| - 3.2 Export of member data | export of member data |
| + 4.1 Export of member data | export of member data |
Raw, that pair reads as one deletion and one insertion. Normalized, both lines match, so the renumbering vanishes and the only real change in the revision stands alone.
Then read for verbs. In the normalized diff, watch what the operator may do, what the member must do, what is retained, and who receives what. A new "may" for the operator or a removed "will" for the member is substance. A rewritten sentence that says the same thing is not.
Findings worth recording take a handful of shapes. A new category of third party the operator may share with. A retention period lengthened or made indefinite. A license widened to cover uses beyond running the service. A notice period shortened or removed. An appeal route added or removed. A jurisdiction changed.
Reading a release history
For self-hosted software the release list is the document, and its shape tells you more than its content.
Reading a release history
Has the release cadence stopped?
Maintenance paused, unpatched risk accumulates
Check who publishes releases
A steady cadence that stops is the loudest signal on the whole watch list: maintenance has paused, and a community running that software accumulates unpatched risk.
A change in who publishes the releases suggests a change in control. A license file change alters what an organizer may run. A major version with a migration note means the upgrade is no longer routine, and communities that skip it will be stranded.
None of this is announced. All of it sits in the repository, dated by version control whether anyone meant to publish it or not.
Triage: three bins, then edit
Every difference goes into one bin before anything is edited.
Three triage bins
Bin
- Field change
- Recorded field value changed
- Context change
- Reason behind entry moved
- Noise
- Restructuring, redesign, marketing
What it is
- Field change
- Log old, new, dates, copies
- Context change
- Log and recheck early
- Noise
- Note checked, do not log
What to do
- Field change
- Context change
- Noise
Field change. A recorded field of the entry now holds a different value. Log old value, new value, both dates, both copies. Update the entry, keep the old value visible, and add the event to the platform's timeline with its interval. That is the change log discipline applied here.
Context change. Nothing in the entry moved, but the reason it held did: an ownership change, a license change, a pause in releases. Log it, and mark the affected fields due for recheck ahead of schedule.
Noise. Restructuring, redesign, renamed features, marketing. Note that the document was checked and found unchanged in substance. Do not log the details.
The third bin exists to keep the first two readable. An entry whose change log records every renamed button is an entry nobody reads.
What an organizer needs from the catalog
An organizer who picked a platform from this catalog wants one thing from its updates: to be told when the ground moved.
So the catalog should carry, per platform, a short dated list of field changes and context changes only, each with the one-sentence consequence for a community running there.
"Export now omits timestamps on the free tier, as of the following date; organizers relying on export for archives should test theirs" is the form, because data portability is the field whose quiet narrowing hurts most. The diff evidence sits behind it for anyone who wants it.
The community platforms overview covers what an organizer does once the ground does move: the migration, the announcement to members, the choice of where to go. The catalog's job ends at telling them early and specifically.
A cadence that holds
Fetch and diff the six documents quarterly for hosted platforms. Check the release list monthly for self-hosted software. On any prompt, whether news, a member report or a reader's message, fetch out of cycle.
Fetch and diff cadence
- QuarterlyFetch and diff six hosted documents
- MonthlyCheck release list for self-hosted software
- On any promptFetch out of cycle
- Every fetchRecord document, date, unchanged
Record every fetch in compact form: document, date, unchanged.
- 2027-03-02, unchanged
- 2027-03-02, changed, two entries added since 2027-02-01
The watch list entry for each platform holds:
- the platform name and a link to its catalog entry
- the six documents, each with last fetch date, last change date, and next due date
- the cadencequarterly for hosted platforms, monthly for a release list
- findings, field changes and context changes only, each dated with its one-sentence consequence
Common questions
A platform's terms changed, but the entry's fields did not. Is that a field change?
No. If no recorded field moved, it is a context change: log the revision with its diff, then reread the entry for fields whose value depended on the old wording. Terms changes travel in groups, and the next revision may move a field.
The help article I was watching was deleted. What do I record?
The deletion, with the date detected and the last saved copy. A vanished article about export or deletion is a finding in itself. The field it supported becomes "documentation removed; last known value as of" the copy's date.
Is it worth watching the status page?
For the pattern, yes. A status page that reports incidents promptly and in detail is evidence about the operator. One that is always green is evidence too, of a different kind. Record the pattern once a year rather than every incident.
How do I know the six documents are the right six?
Because every field in the entry traces to one of them, which is how the entry was built in the first place. If a field is added whose source is a seventh document, add that document to the watch list the same day.







