BundleConceptWriter returns agent-facing prose to library callers instead of a typed result
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
Research direction
Start with the public API for BundleConceptWriter in src/OKF4net and inspect WriteConceptAsync and its sibling methods, then read related issue #211 for context on error text. Decide the typed result shape and update the breaking API documentation and CHANGELOG; done means callers can distinguish outcomes and access result details without parsing prose.
Written by the indexing model from the issue text.
Description
Area
src/OKF4net — BundleConceptWriter public API.
Question
WriteConceptAsync (and siblings) return agent-facing prose to library callers: "Written tables/orders (new, 524 bytes). Remember to run okf_regenerate_indexes.", and expected failures as strings starting with Error: …. A library caller has to parse text to know whether the write happened. The tool wording belongs in OkfBundleTools; the core could return a typed result (outcome, key, version, bytes, refusal reason).
Breaking API change — design and CHANGELOG needed. Related: #211 (path-free I/O error texts in the same strings).
Found while writing the #174 tutorials.
- Dominant language
- C#
- Stars
- 4
- Forks
- 1
- Avg merge
- 1d 4h
- Merged PRs (30d)
- 32
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from jchable/okf4net
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
Maintainers usually reply within 1 day
-
.NET bug
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
Maintainers usually reply within 1 day
-
test
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
documentation good first issue
Difficulty 1/5 1-3 hours Newbie friendliness 90/100
Maintainers usually reply within 1 day
-
documentation good first issue
Difficulty 1/5 Under an hour Newbie friendliness 82/100
Maintainers usually reply within 1 day
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
area/backend type/bug
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
umbraco/Umbraco-CMS#24668 · 1 comment ·
Maintainers usually reply within 1 day
-
Pri3
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
MicrosoftDocs/windows-dev-docs#6205 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Maintainers usually reply within 1 day
-
area-ai untriaged
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
dotnet/extensions#7956 ·
Maintainers usually reply within 1 day