I removed schema.example validation from the scope of this task. It's already partially implemented but requires some extra consideration in sync with T421375: Improve linting - requestBody and response examples.

Thu, Apr 9, 11:08 AM · MediaWiki-REST-API, Tool-wmf-openapi-linter, MW-Interfaces-Team, OKR-Work

KBach updated the task description for T422600: Add the remaining linting rules.

Thu, Apr 9, 11:03 AM · MediaWiki-REST-API, Tool-wmf-openapi-linter, MW-Interfaces-Team, OKR-Work

KBach added a comment to T422504: Add linting rules for operations and paths.

Validation of parameter examples is now merged and removed from the scope of this task.

Thu, Apr 9, 10:43 AM · MediaWiki-REST-API, Tool-wmf-openapi-linter, OKR-Work, MW-Interfaces-Team

KBach updated the task description for T422504: Add linting rules for operations and paths.

Thu, Apr 9, 10:43 AM · MediaWiki-REST-API, Tool-wmf-openapi-linter, OKR-Work, MW-Interfaces-Team

KBach edited parent tasks for T422484: [5.2.5b Epic] Add security mechanism information to the MediaWiki REST API description, added: T422476: [Hypothesis] 5.2.5b: Productionalize API spec linting; removed: T422480: [5.2.5b Epic] Improve MediaWiki REST API OpenAPI description.

Thu, Apr 9, 10:36 AM · [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach removed a subtask for T422480: [5.2.5b Epic] Improve MediaWiki REST API OpenAPI description: T422484: [5.2.5b Epic] Add security mechanism information to the MediaWiki REST API description.

Thu, Apr 9, 10:36 AM · Patch-For-Review, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach added a subtask for T422476: [Hypothesis] 5.2.5b: Productionalize API spec linting: T422484: [5.2.5b Epic] Add security mechanism information to the MediaWiki REST API description.

Thu, Apr 9, 10:36 AM · Tech-Docs-Team, Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, OKR-Work

KBach added a comment to T422739: OpenAPI linting: Add missing OpenAPI spec elements to Response Components.

It's not exactly a collision, but the example validation seems to need a bit more work. The way we originally defined the rules was somewhat in isolation from one another, so some interactions between objects might not be accounted for.

Thu, Apr 9, 9:13 AM · Patch-For-Review, MW-Interfaces-Team, MediaWiki-REST-API, Tool-wmf-openapi-linter

Wed, Apr 8

KBach added a subtask for T422476: [Hypothesis] 5.2.5b: Productionalize API spec linting: T405571: Improve OAD style guide based on feedback and emerging requirements.

Wed, Apr 8, 2:11 PM · Tech-Docs-Team, Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, OKR-Work

KBach removed a subtask for T405569: API docs work - Q2 and Q3 2025/26: T405571: Improve OAD style guide based on feedback and emerging requirements.

Wed, Apr 8, 2:11 PM · Tech-Docs-Team

KBach edited parent tasks for T405571: Improve OAD style guide based on feedback and emerging requirements, added: T422476: [Hypothesis] 5.2.5b: Productionalize API spec linting; removed: T405569: API docs work - Q2 and Q3 2025/26.

Wed, Apr 8, 2:11 PM · Tech-Docs-Team

KBach added a subtask for T422479: [5.2.5b Epic] Implement and improve linter rules: T415914: Linter: Split rules into more logical groupings..

Wed, Apr 8, 2:07 PM · Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach added a parent task for T415914: Linter: Split rules into more logical groupings.: T422479: [5.2.5b Epic] Implement and improve linter rules.

Wed, Apr 8, 2:07 PM · MW-Interfaces-Team, Tool-wmf-openapi-linter, Essential-Work, MediaWiki-REST-API

KBach edited parent tasks for T414974: Fix linter issues discovered during implementation of the OAD example, added: T422479: [5.2.5b Epic] Implement and improve linter rules; removed: T407989: Implement OpenAPI linting rules based on the style guide.

Wed, Apr 8, 2:05 PM · MW-Interfaces-Team (MWI-Sprint-31 (2026-04-07 to 2026-04-21)), Tool-wmf-openapi-linter

KBach removed a subtask for T407989: Implement OpenAPI linting rules based on the style guide: T414974: Fix linter issues discovered during implementation of the OAD example.

Wed, Apr 8, 2:05 PM · Epic, MW-Interfaces-Team (MWI-Roadmap), OKR-Work, [MWI] FY2025-26 Q2

KBach added a subtask for T422479: [5.2.5b Epic] Implement and improve linter rules: T414974: Fix linter issues discovered during implementation of the OAD example.

Wed, Apr 8, 2:05 PM · Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach created T422600: Add the remaining linting rules.

Wed, Apr 8, 10:43 AM · MediaWiki-REST-API, Tool-wmf-openapi-linter, MW-Interfaces-Team, OKR-Work

KBach added a comment to T422504: Add linting rules for operations and paths.

I updated the task title and description - adding path and removing parameter validation. Validation of parameter examples (currently crossed out in the description) is awaiting review in this merge request.

Wed, Apr 8, 9:26 AM · MediaWiki-REST-API, Tool-wmf-openapi-linter, OKR-Work, MW-Interfaces-Team

KBach renamed T422504: Add linting rules for operations and paths from Add linting rules for operations and parameters to Add linting rules for operations and paths.

Wed, Apr 8, 9:23 AM · MediaWiki-REST-API, Tool-wmf-openapi-linter, OKR-Work, MW-Interfaces-Team

KBach updated the task description for T422504: Add linting rules for operations and paths.

Wed, Apr 8, 9:22 AM · MediaWiki-REST-API, Tool-wmf-openapi-linter, OKR-Work, MW-Interfaces-Team

Tue, Apr 7

KBach updated the task description for T422504: Add linting rules for operations and paths.

Tue, Apr 7, 2:49 PM · MediaWiki-REST-API, Tool-wmf-openapi-linter, OKR-Work, MW-Interfaces-Team

KBach created T422504: Add linting rules for operations and paths.

Tue, Apr 7, 2:25 PM · MediaWiki-REST-API, Tool-wmf-openapi-linter, OKR-Work, MW-Interfaces-Team

KBach renamed T422476: [Hypothesis] 5.2.5b: Productionalize API spec linting from [Hypothesis] 5.2.5b: Productionalize API Spec Linting to [Hypothesis] 5.2.5b: Productionalize API spec linting.

Tue, Apr 7, 1:30 PM · Tech-Docs-Team, Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, OKR-Work

KBach removed a project from T422484: [5.2.5b Epic] Add security mechanism information to the MediaWiki REST API description: Epic.

Tue, Apr 7, 12:07 PM · [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach created T422484: [5.2.5b Epic] Add security mechanism information to the MediaWiki REST API description.

Tue, Apr 7, 12:07 PM · [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach created T422483: [5.2.5b Epic] Create a proof of concept of a CI workflow with the spec linter.

Tue, Apr 7, 11:34 AM · Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach added a parent task for T420988: Support examples for request parameters in OpenAPI descriptions: T422480: [5.2.5b Epic] Improve MediaWiki REST API OpenAPI description.

Tue, Apr 7, 11:23 AM · MW-Interfaces-Team, MediaWiki-REST-API

KBach added a subtask for T422480: [5.2.5b Epic] Improve MediaWiki REST API OpenAPI description: T420988: Support examples for request parameters in OpenAPI descriptions.

Tue, Apr 7, 11:23 AM · Patch-For-Review, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach created T422480: [5.2.5b Epic] Improve MediaWiki REST API OpenAPI description.

Tue, Apr 7, 11:22 AM · Patch-For-Review, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach added a project to T422479: [5.2.5b Epic] Implement and improve linter rules: Epic.

Tue, Apr 7, 11:14 AM · Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach added a parent task for T419576: Add tests to ensure consistency between OAD example and OpenAPI linter: T422479: [5.2.5b Epic] Implement and improve linter rules.

Tue, Apr 7, 11:13 AM · Tool-wmf-openapi-linter, MW-Interfaces-Team

KBach added a subtask for T422479: [5.2.5b Epic] Implement and improve linter rules: T419576: Add tests to ensure consistency between OAD example and OpenAPI linter.

Tue, Apr 7, 11:13 AM · Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach added a parent task for T421375: Improve linting - requestBody and response examples: T422479: [5.2.5b Epic] Implement and improve linter rules.

Tue, Apr 7, 11:13 AM · Tool-wmf-openapi-linter, MW-Interfaces-Team

KBach added a subtask for T422479: [5.2.5b Epic] Implement and improve linter rules: T421375: Improve linting - requestBody and response examples.

Tue, Apr 7, 11:13 AM · Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach updated the task description for T422479: [5.2.5b Epic] Implement and improve linter rules.

Tue, Apr 7, 11:11 AM · Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach created T422479: [5.2.5b Epic] Implement and improve linter rules.

Tue, Apr 7, 11:09 AM · Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, Epic, OKR-Work

KBach created T422476: [Hypothesis] 5.2.5b: Productionalize API spec linting.

Tue, Apr 7, 10:40 AM · Tech-Docs-Team, Tool-wmf-openapi-linter, [MWI] FY2025-26 Q4, OKR-Work

Mon, Mar 30

KBach added a watcher for Tool-wmf-openapi-linter: KBach.

Mon, Mar 30, 1:19 PM

Fri, Mar 27

KBach added a comment to T405571: Improve OAD style guide based on feedback and emerging requirements.

I've updated the style guide with new information based on feedback:

Added rules for the following fields: info.license, info.termsOfService, and operationId
Expanded the section about linking to external resources
Added recommendations for Boolean properties and the format field in schemas
Marked some fields as required

Fri, Mar 27, 9:09 AM · Tech-Docs-Team

Thu, Mar 26

KBach created T421375: Improve linting - requestBody and response examples.

Thu, Mar 26, 1:24 PM · Tool-wmf-openapi-linter, MW-Interfaces-Team

Wed, Mar 25

KBach added a comment to T411486: Java missing from PATH in Clojure buildpack on Toolforge.

Yes, with the help of #wikimedia-cloud :) It'd still be great to have it in $PATH though!

Wed, Mar 25, 9:42 AM · cloud-services-team, Toolforge

KBach added a comment to T411486: Java missing from PATH in Clojure buildpack on Toolforge.

I ran into this again. When using --use-latest-versions, the workaround (using /app/.jdk/bin/java) no longer works. I'll try to locate and use a different binary.

Wed, Mar 25, 8:53 AM · cloud-services-team, Toolforge

Tue, Mar 17

KBach moved T415875: Create a unified changelog for Wikimedia APIs from In progress to Done on the Tech-Docs-Team board.

Tue, Mar 17, 9:52 AM · Tech-Docs-Team

KBach added a comment to T415875: Create a unified changelog for Wikimedia APIs.

First versions of the unified changelog and the style guide are now published - closing this task as resolved. Any future work on these documents will happen in separate tasks.

Tue, Mar 17, 9:26 AM · Tech-Docs-Team

KBach closed T415875: Create a unified changelog for Wikimedia APIs, a subtask of T405569: API docs work - Q2 and Q3 2025/26, as Resolved.

Tue, Mar 17, 9:23 AM · Tech-Docs-Team

KBach closed T415875: Create a unified changelog for Wikimedia APIs as Resolved.

Tue, Mar 17, 9:22 AM · Tech-Docs-Team

KBach updated the task description for T415875: Create a unified changelog for Wikimedia APIs.

Tue, Mar 17, 9:20 AM · Tech-Docs-Team

Mon, Mar 16

KBach updated the task description for T405571: Improve OAD style guide based on feedback and emerging requirements.

Mon, Mar 16, 11:05 AM · Tech-Docs-Team

KBach closed T419881: Upgrade Material for MkDocs to 9.7.1 or above as Declined.

Thanks @bd808. It seems we can use different criteria to decide on an upgrade then. Closing this as declined.

Mon, Mar 16, 9:55 AM · Wikimedia-Developer-Portal

Thu, Mar 12

KBach created T419881: Upgrade Material for MkDocs to 9.7.1 or above.

Thu, Mar 12, 3:51 PM · Wikimedia-Developer-Portal

Mar 11 2026

KBach moved T416586: Review reference documentation moved off the API Portal from Backlog to In progress on the Tech-Docs-Team board.

Mar 11 2026, 1:09 PM · Tech-Docs-Team

KBach moved T410087: Create example/test OAD from Waiting for feedback to Done on the Tech-Docs-Team board.

Mar 11 2026, 1:06 PM · Tech-Docs-Team, MW-Interfaces-Team, OKR-Work

KBach closed T410087: Create example/test OAD, a subtask of T405571: Improve OAD style guide based on feedback and emerging requirements, as Resolved.

Mar 11 2026, 1:05 PM · Tech-Docs-Team

KBach closed T410087: Create example/test OAD, a subtask of T406171: [Hypothesis] 5.2.5: Spec linting experiment, as Resolved.

Mar 11 2026, 1:05 PM · OKR-Work, [MWI] FY2025-26 Q2, MW-Interfaces-Team (MWI-Roadmap)

KBach closed T410087: Create example/test OAD as Resolved.

Closing this task as resolved - first version of the OAD example is available under repos/technical-documentation on GitLab. Work on the example continues in separate streams: