Skip to content

chore: write the whole changelog in the standard format - #246

Merged
oleksandr-nc merged 1 commit into
mainfrom
chore/changelog-format
Oct 23, 2026
Merged

oleksandr-nc merged 1 commit into
mainfrom
chore/changelog-format

Conversation

@oleksandr-nc

@oleksandr-nc oleksandr-nc commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Every version of CHANGELOG.md has the layout of integration_youtube's changelog

The sections of 1.2.1 and older had no blank line after their headings, those of 1.0.7 and older an en dash in the version heading, and their entries were lowercase notes such as "bump js libs", with issue links and authors on lines of their own. Now every version heading is ## X.Y.Z - YYYY-MM-DD with a blank line after each heading, and the entries of 1.4.2 and older are in sentence case without trailing periods, issue links or authors, with dependency updates as "Update dependencies", or "Update dependencies & translations" where the entry named translations too, which in 1.0.0 merges its two entries "bump js libs" and "add new translations". The entries of 1.4.3 to 1.5.1 keep their wording, except that 1.5.0's two entries in the past tense, which begin with "Updated" and one of which also has "synced", are in the imperative, and dates stay as written.

The Nextcloud versions follow appinfo/info.xml at each version's tag

Each version lists the Nextcloud versions it gained as "Added support for Nextcloud N" under Added and those it dropped under Removed. No entry said these: 1.0.1 raised the maximum to 23, 1.0.5 to 27, 1.2.0 to 30 and 1.2.1 to 31; 1.0.6 raised the minimum from 22 to 25; 1.4.2 moved the range from 30-33 to 33-35 and the PHP minimum from 8.1 to 8.2. The support for Nextcloud 24 and 25 that came with 1.0.2 and 1.0.3, which have no section, is under 1.0.4, and 0.0.1 is the initial release for Nextcloud 20 and 21. Two old entries now say what their change did: 0.0.9 let users who are not Nextcloud admins connect to a self-hosted Jira (issue #9), and 0.0.15 was a republish to use the new app certificate.

🤖 AI (if applicable)

  • The content of this PR was partly or fully generated using AI

@oleksandr-nc
oleksandr-nc force-pushed the chore/changelog-format branch from 7cb1b6d to 5fd200b Compare October 23, 2026 15:13
The sections of 1.2.1 and older had no blank line after their headings,
those of 1.0.7 and older an en dash in the version heading, and their
entries were lowercase notes such as "bump js libs", with issue links
and authors on lines of their own and "* the app" for 0.0.1. 1.4.0 and
1.4.1 listed Nextcloud support under Changed, and three 1.4.2 entries
ended in a period, one of them after an issue number.

CHANGELOG.md now has the layout of integration_youtube's changelog in
every version: "## X.Y.Z - YYYY-MM-DD" headings and a blank line after
each heading. The entries of 1.4.2 and older are in sentence case,
without trailing periods, issue links or authors, with the Nextcloud
versions the app gained as "Added support for Nextcloud N" under Added
and those it dropped under Removed, and dependency updates as "Update
dependencies", or "Update dependencies & translations" where the entry
named translations too, which in 1.0.0 merges its two entries "bump js
libs" and "add new translations". The entries of 1.4.3 to 1.5.1 keep
their wording, except that 1.5.0's two entries in the past tense, which
begin with "Updated" and one of which also has "synced", are in the
imperative, and dates stay as written.

The Nextcloud versions follow appinfo/info.xml at each version's tag,
and no entry said these: 1.0.1 raised the maximum to 23, 1.0.5 to 27,
1.2.0 to 30 and 1.2.1 to 31; 1.0.6 raised the minimum from 22 to 25;
1.4.2 moved the range from 30-33 to 33-35 and the PHP minimum from 8.1
to 8.2. The support for Nextcloud 24 and 25 that came with 1.0.2 and
1.0.3, which have no section, is under 1.0.4. 0.0.1 was released for
Nextcloud 20 and 21, and 0.0.12 raised the maximum to 22. 1.4.0 was the
first version to declare PHP, so its Removed line names no PHP version.
The 0.0.15 entry says what the commit behind it did, republish to use
the new app certificate, and the 0.0.9 entry says what its fix did:
users who are not Nextcloud admins could not connect to a self-hosted
Jira, and now can.

Signed-off-by: Oleksander Piskun <oleksandr2088@icloud.com>
@oleksandr-nc
oleksandr-nc force-pushed the chore/changelog-format branch from 5fd200b to 06be58b Compare October 23, 2026 15:20
@oleksandr-nc
oleksandr-nc merged commit ddf6dd9 into main Oct 23, 2026
24 checks passed
@oleksandr-nc
oleksandr-nc deleted the chore/changelog-format branch October 23, 2026 15:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant