Consumer documentation: the developer-experience findings #504

Activity

1. Blind-Striker

   added this to the 1.0 milestone on Oct 18, 2026
2. Blind-Striker

   added sub-issues on Oct 18, 2026

   • Generated doc comments: payload wording on no-content envelopes and adapters #177
   • Docs: credentials and sessions share the server's data root #279
   • Docs: what a private launch inherits (MCP servers, agent instructions) #280
   • Docs: an unfiltered session listing spans the whole profile #281
   • Docs: the HTTP surface has no file-content search #282
   • Docs: a server stopped with SIGTERM reports Exited with code 130, not Signaled #283
   • Docs: a normal PTY read completes when the shell exits #284
   • Docs: fs.list paths are OS-native, with a trailing separator on directories #285
   • Docs: a PATH-resolved launch on Windows runs through the npm shim (ProcessId, linger after a hard kill) #290
   • Docs: how SessionListRequest.Directory matches #304
   • Docs: mention SwitchModelAsync beside choosing a model #305
   • XML docs on client operations can't be curated; EventsClient.SubscribeAsync doesn't mention reconnect #313
   • docs: keep the event-bus loop short; a held event delays noticing a lost server #316
   • README test matrix lists net8.0 and net9.0 after the target-framework transition #351
   • Docs: a config update is not visible to locations the server already loaded #507
   • Docs: a recipe for an isolated background service #508
   • Docs: a restartable private server on a fixed endpoint #509
   • Docs: a cancelled StartAsync leaves no process behind #510
   • Error message: tell a refused connection from a stream that sent no event #511
   • XML docs: repeat the cold-VCS caveat on VcsClient.GetVcsAsync #512
3. Blind-Striker

   added sub-issues on Oct 18, 2026

   • Docs: one session-replay recipe #513
   • Docs: Windows temp cleanup after a private server needs location eviction #514
   • Docs: choosing a model, an enabled model is not necessarily usable #515
   • XML docs: the long tail of placeholder summaries on public generated members #478
4. Blind-Striker

   moved this to Queue in opencode-sdk-dotneton Oct 18, 2026
5. Blind-Striker

   added this to opencode-sdk-dotneton Oct 18, 2026
6. Blind-Striker commented on Oct 18, 2026

   

   Blind-Striker

   on Oct 18, 2026

   CollaboratorAuthor

   More actions

   A follow-up from the 2.0.32 light DevEx round (2026-10-18): #476 fixed the contradictory timeout sentence, but getting-started's options table still names no timeout options (NetworkTimeout and the per-call request options). A builder looked there first. It belongs with the docs sweep here.
7. Blind-Striker

   removed sub-issues on Oct 23, 2026

   • Generated doc comments: payload wording on no-content envelopes and adapters #177
   • Error message: tell a refused connection from a stream that sent no event #511