Write release notes for kartotherian deployment
Closed, ResolvedPublic2 Estimated Story Points
Actions

Assigned To

Authored By

	awight
	Jun 7 2022, 10:42 AM

Description

Find a nice home for posting release notes on an ongoing basis.
Take the git log for this release and turn it into short English summaries of the new features and any breaking changes or new configuration:

git log --reverse 2ef5c2d...e91c46a

Release notes

User experience

New feature: New support for geopoints, given Wikidata IDs or a custom SPARQL query (T307695).
- Enabled on the beta cluster but not in production yet.
Bugfix: When duplicate Wikidata IDs appear, don't crash. Merge or render them all (T306540).
Bugfix: Hide unwanted markers from rendered geolines (T292613).

Technical debt

These are tracked under T302053.

Update linters to the newest versions still supporting node 10.
Replace some promises with async/await.
Refactor geoshapes as pure functions.
Diagram illustrating the versioned maps data flow (T294338).
Fail faster when the geoshapes endpoint is down (T307671).

Details

	Subject	Repo	Branch	Lines +/-
	Add Phabricator links to the new changelog	mediawiki/services/kartotherian	master	+28 -17
	Start a changelog.md file	mediawiki/services/kartotherian	master	+42 -0

Customize query in gerrit

Related Objects
Search...

Status	Subtype	Assigned	Task
Open		None	T67626 [Epic] Support for queries on-wiki (automated list generation)
Resolved		ECohen_WMDE	T188291 Display point features (coordinates) from the results of a SPARQL query on a map in Wikipedia
Resolved		None	T302297 Display geopoint SPARQL queries in a map in Wikipedia (GeoPoints)
Resolved		None	T307695 Display coordinate markers in Kartographer maps from QID
Resolved		thiemowmde	T306540 Handling of multiple location values from wikidata items
Resolved	BUG REPORT	None	T292613 Remove pushpin markers in Kartographer maps for geoline objects
Resolved		lilients_WMDE	T309174 Deploy new geoshapes work (including geopoints) to the beta cluster
Resolved		thiemowmde	T310058 Write release notes for kartotherian deployment

Event Timeline

awight created this task.Jun 7 2022, 10:42 AM

awight added a project: WMDE-TechWish-Sprint-2022-06-08.Jun 7 2022, 11:10 AM

WMDE-Fisch set the point value for this task to 2.Jun 9 2022, 12:17 PM

Lena_WMDE moved this task from Backlog to In sprint on the WMDE-GeoInfo-FocusArea board.Jun 10 2022, 7:18 AM

awight mentioned this in T310349: Kartotherian production deployment.Jun 10 2022, 11:20 AM

awight updated the task description. (Show Details)Jun 10 2022, 12:02 PM

awight updated the task description. (Show Details)

awight moved this task from Sprint Backlog to Tech Review on the WMDE-TechWish-Sprint-2022-06-08 board.

awight updated the task description. (Show Details)Jun 10 2022, 12:24 PM

awight updated the task description. (Show Details)

Great overview, @awight. I have some small adjustments:

New feature: New support for geopoints, given Wikidata IDs (T305822)

I would link to the epic instead: T307695

Bugfix: Don't crash when duplicate Wikidata IDs appear (T306540).

Maybe we could add which approach we selected to achieve this?

Bugfix: Hide markers from rendered geolines (T292613).

I would add: Hide unwanted markers ...

Technical debt

Update linters to the newest versions still supporting node 10.

Replace some promises with async/await.

Refactor geoshapes as pure functions.

Do we have links for these three points as well?

awight updated the task description. (Show Details)Jun 15 2022, 10:48 AM

In T310058#7998941, @lilients_WMDE wrote:

I have some small adjustments:

Thanks for the help! I've adjusted the notes according to your suggestions.

Do we have links for these three points as well?

These were a bit under the radar, the changes were made without associated tasks. IMHO we shouldn't link to the (many) gerrit patches because it will clutter the notes with information that would be easier for the appropriate audience to find by reading through the code or commit log themselves. But this is based on assumptions, let me know if you think otherwise.

IMHO we shouldn't link to the (many) gerrit patches because it will clutter the notes with information

Agreed. Maybe we could create a tech cleanup ticket and list the patches there retroactively? 🤔

awight updated the task description. (Show Details)Jun 17 2022, 9:04 AM

awight moved this task from Tech Review to Demo on the WMDE-TechWish-Sprint-2022-06-08 board.Jun 17 2022, 9:08 AM

WMDE-Fisch moved this task from In sprint to Ready for pickup on the WMDE-GeoInfo-FocusArea board.Jun 22 2022, 8:07 AM

Lena_WMDE renamed this task from Write release notes for June 2022 kartotherian deployment to Write release notes for kartotherian deployment.Jul 6 2022, 7:17 AM

thiemowmde added a project: WMDE-TechWish-Sprint-2022-07-20.Jul 20 2022, 8:30 AM

thiemowmde moved this task from Ready for pickup to In sprint on the WMDE-GeoInfo-FocusArea board.

thiemowmde updated the task description. (Show Details)Jul 20 2022, 8:56 AM

Bugfix: When duplicate Wikidata IDs appear, don't crash. Merge or render them all (T306540).

I think we decided to render them all and not merge. We should update this here.

Find a nice home for posting release notes on an ongoing basis.

Maybe here https://github.com/wikimedia/mediawiki-services-kartotherian/tree/master/docs? @thiemowmde?

lilients_WMDE added a subscriber: thiemowmde.Jul 26 2022, 12:20 PM

Change 817288 had a related patch set uploaded (by Thiemo Kreuz (WMDE); author: Thiemo Kreuz (WMDE)):

[mediawiki/services/kartotherian@master] Start a release-notes.md file

https://gerrit.wikimedia.org/r/817288

gerritbot added a project: Patch-For-Review.Jul 26 2022, 3:17 PM

lilients_WMDE moved this task from Sprint Backlog to Tech Review on the WMDE-TechWish-Sprint-2022-07-20 board.Jul 27 2022, 9:23 AM

Andrew-WMDE moved this task from Tech Review to Demo on the WMDE-TechWish-Sprint-2022-07-20 board.Aug 1 2022, 9:16 AM

Change 817288 merged by jenkins-bot:

[mediawiki/services/kartotherian@master] Start a changelog.md file

https://gerrit.wikimedia.org/r/817288

Maintenance_bot removed a project: Patch-For-Review.Aug 1 2022, 9:30 AM

lilients_WMDE mentioned this in rMSKAd09ed76aca16: Start a changelog.md file.Aug 1 2022, 9:31 AM

Change 819092 had a related patch set uploaded (by Thiemo Kreuz (WMDE); author: Thiemo Kreuz (WMDE)):

[mediawiki/services/kartotherian@master] Add Phabricator links to the new changelog

https://gerrit.wikimedia.org/r/819092

gerritbot added a project: Patch-For-Review.Aug 1 2022, 2:53 PM

Change 819092 merged by jenkins-bot:

[mediawiki/services/kartotherian@master] Add Phabricator links to the new changelog

https://gerrit.wikimedia.org/r/819092

thiemowmde mentioned this in rMSKA285fc7db8de8: Add Phabricator links to the new changelog.Aug 2 2022, 7:37 AM

thiemowmde closed this task as Resolved.Aug 2 2022, 8:09 AM

thiemowmde claimed this task.

Maintenance_bot removed a project: Patch-For-Review.Aug 2 2022, 8:30 AM

Write release notes for kartotherian deploymentClosed, ResolvedPublic2 Estimated Story PointsActions