Skip to content

Getting started shows a read-only model, async-only examples, and inferred parameters - #112

Merged
electricessence merged 4 commits into
masterfrom
docs/getting-started-init
Nov 10, 2026
Merged

electricessence merged 4 commits into
masterfrom
docs/getting-started-init

Conversation

@electricessence

Copy link
Copy Markdown
Collaborator

What changes

  • The Post model uses { get; init; } for every property, and Id is required.
  • The "Your first query" paragraph says init (C# 9) and required (C# 11) work, so read-only models are fine.
  • Every example on Getting started is async: the factory and own-connection side by side, and the plain ADO.NET and extensions before/after (OpenAsync, ExecuteReaderAsync, ReadAsync, await ... ToListAsync(cancellationToken)). Row-against-row alignment and the "nothing" rows are unchanged.
  • Coming from Dapper shows the same two extension snippets, so its Dapper snippet now uses QueryAsync<T>, keeping that comparison async against async. Its "Rows." note says so. Line counts are unchanged.
  • The first AddParam(variable) in each example now carries a short comment: name and type inferred from the variable (or the member). Same in the READMEs.

Why

A { get; set; } model hides that read-only classes work, and a sync terminal teaches the fallback instead of the normal way. The comment shows that a parameter needs neither a typed name nor a type.

Checks

Gate: Release and Debug builds 0 warnings; 9255 tests passed in each, 0 failed; all 96 sample checks passed; style and analyzers 0 findings on every project; DocFX 0 warnings, 0 errors.

🤖 Generated with Claude Code

electricessence and others added 4 commits November 10, 2026 08:22
…ed member

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…fore and after await their terminals

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…m the variable

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…nc too

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@electricessence
electricessence merged commit adc844e into master Nov 10, 2026
2 checks passed
@electricessence
electricessence deleted the docs/getting-started-init branch November 10, 2026 16:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant