From 71e1d33c618ea8489fc79d36ba0439008e7e96a2 Mon Sep 17 00:00:00 2001 From: Florin Barbu Date: Mon, 21 Sep 2026 15:27:37 +0300 Subject: [PATCH] docs(nim): add 2026 Q4 commitments and tasks --- content/nim/ift/2026q4-nim-core-libs.md | 81 +++++++++++++++++++++++++ content/nim/ift/2026q4-nimble.md | 57 +++++++++++++++++ content/nim/index.md | 7 ++- 3 files changed, 144 insertions(+), 1 deletion(-) create mode 100644 content/nim/ift/2026q4-nim-core-libs.md create mode 100644 content/nim/ift/2026q4-nimble.md diff --git a/content/nim/ift/2026q4-nim-core-libs.md b/content/nim/ift/2026q4-nim-core-libs.md new file mode 100644 index 0000000000..65e6e389db --- /dev/null +++ b/content/nim/ift/2026q4-nim-core-libs.md @@ -0,0 +1,81 @@ +--- +title: 2026q4 Nim Core Libraries +tags: + - "2026q4" + - "nim" + - "ift" +draft: false +description: Maintain Nim core libraries, improve documentation, and integrate nimlangserver fixes with a consistent LSP protocol model. +--- + +`ift-ts:nim:ift:2026q4-nim-core-libs` + +## Description + +Maintain and document the foundational Nim libraries used by IFT teams. +Improve nimlangserver by reviewing and integrating applicable fixes from the recent fork and following the separation of protocol handling, JSON serialization, and protocol data models used by nim-web3. + +## Task List + +### Documentation Improvement + +* fully qualified name: `ift-ts:nim:ift:2026q4-nim-core-libs:docs-improvement` +* owner: Constantine +* status: not started +* start-date: 2026/10/01 +* end-date: 2026/12/31 + +#### Description + +Continue improving documentation for Nim core libraries, including missing API guidance, runnable examples, and integration notes needed by downstream teams. +Improve documentation tooling where it helps keep package documentation accurate and maintainable. + +#### Deliverables + +- Documentation PRs covering identified gaps and downstream usage examples. +- Documentation tooling improvements and validation of the updated examples or builds. + +### Maintenance + +* fully qualified name: `ift-ts:nim:ift:2026q4-nim-core-libs:maintenance` +* owner: Constantine +* status: not started +* start-date: 2026/10/01 +* end-date: 2026/12/31 + +#### Description + +Provide ongoing maintenance and fixes across Nim core libraries. +Triage issues, address regressions and compatibility problems, support downstream consumers, and maintain tests and CI as dependencies and toolchains evolve. + +#### Deliverables + +- PRs fixing library defects and maintaining compatibility, tests, and CI. +- Tracked issues and verification results for downstream integration problems. + +### Nimlangserver improvements + +* fully qualified name: `ift-ts:nim:ift:2026q4-nim-core-libs:nimlangserver` +* owner: TBD +* status: not started +* start-date: 2026/10/01 +* end-date: 2026/12/31 + +#### Description + +Review the recent nimlangserver fork and cherry-pick applicable improvements and fixes into the team's maintained branch, adapting changes where needed. +Identify the fork URL, source commits, and target branch before selecting changes; these references remain to be specified. + +Use the nim-web3 approach as the model for the LSP implementation: +- Keep JSON-RPC protocol handling in `nim-json-rpc`. +- Define an LSP-specific `nim-json-ser` flavor for interpreting and emitting protocol JSON, including null values, number formatting, and missing or extra fields. +- Represent the protocol data model with Nim objects that map directly to the [LSP 3.18 specification](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.18/specification/), starting with the messages and structures used by nimlangserver today. +- Make additional protocol objects straightforward to add using the same model. Generating objects from the specification is optional; the task does not require implementing every LSP feature. +- Add regression tests for imported fixes and serialization tests for the supported protocol objects and edge cases. + +#### Deliverables + +- A fork review identifying source commits, target branch, selected fixes, and deferred changes. +- PRs integrating applicable fork fixes and improvements into the maintained branch. +- An LSP JSON serialization flavor and Nim protocol objects for the currently used messages and structures. +- Regression and serialization tests, plus guidance for adding further protocol objects. diff --git a/content/nim/ift/2026q4-nimble.md b/content/nim/ift/2026q4-nimble.md new file mode 100644 index 0000000000..4b81e34e90 --- /dev/null +++ b/content/nim/ift/2026q4-nimble.md @@ -0,0 +1,57 @@ +--- +title: 2026q4 Nimble +tags: + - "2026q4" + - "nim" + - "ift" +draft: false +description: Continue Nimble development and review its integration into Messaging, Storage, and Nimbus CI workflows. +--- + +`ift-ts:nim:ift:2026q4-nimble` + +## Description + +Continue improving Nimble as a reliable package and build tool for downstream teams. +Build on the Q3 development track and review how Messaging, Storage, and Nimbus use Nimble in CI, identifying integration gaps and coordinating fixes with each team. + +## Task List + +### Nimble development + +* fully qualified name: `ift-ts:nim:ift:2026q4-nimble:development` +* owner: Juan +* status: not started +* start-date: 2026/10/01 +* end-date: 2026/12/31 + +#### Description + +Continue Nimble development, stabilization, and issue resolution from Q3. +Prioritize outstanding development goals, dependency resolution and lockfile reliability, package installation, and build behavior needed by downstream projects. +Add regression coverage for fixes and update usage documentation when behavior changes. + +#### Deliverables + +- PRs implementing Nimble improvements and fixes with regression coverage. +- Updated documentation and tracked follow-ups for outstanding development or compatibility issues. + +### CI integration review + +* fully qualified name: `ift-ts:nim:ift:2026q4-nimble:ci-integration-review` +* owner: TBD +* status: not started +* start-date: 2026/10/01 +* end-date: 2026/12/31 + +#### Description + +Review Nimble integration into the CI workflows of Logos Messaging, Logos Storage, and Nimbus. +For each project, inspect the current integration, dependency and lockfile handling, toolchain selection, caching, and build/test execution on its supported CI platforms. +Identify gaps or failures, agree follow-up work with the project owners, and contribute Nimble or workflow fixes where needed. + +#### Deliverables + +- A review for each of Messaging, Storage, and Nimbus documenting current integration, findings, and recommended changes. +- Issues or PRs addressing integration gaps, with ownership for remaining follow-ups. +- CI validation results for changes made during the review. diff --git a/content/nim/index.md b/content/nim/index.md index 1b5ee6b877..6df7157c79 100644 --- a/content/nim/index.md +++ b/content/nim/index.md @@ -11,6 +11,12 @@ tags: [[nim/preview|Roadmap Preview]] +## 2026q4 + +### `ift:` +* [[nim/ift/2026q4-nim-core-libs|nim-core-libs]] +* [[nim/ift/2026q4-nimble|nimble]] + ## 2026q3 ### `nimbus:` @@ -72,4 +78,3 @@ tags: * [[nim/ift/2025q1-nim-ide-tooling|2025q1-nim-ide-tooling]] * [[nim/ift/2025q1-nimble|2025q1-nimble]] -