Skip to content

docs: explain numeric converter culture - #1005

Merged
glennawatson merged 1 commit into
mainfrom
CP_docs-converter-culture
Oct 13, 2026
Merged

glennawatson merged 1 commit into
mainfrom
CP_docs-converter-culture

Conversation

@ChrisPulman

Copy link
Copy Markdown
Member

Summary

Document the consistent current-culture contract for numeric converters and generated bindings.

  • Explain that defaults, nullable numbers, and format hints use the current culture.
  • Quote the French float-formatting example from the binding examples.
  • Explain how to request invariant output through an explicit conversion.

Why

Companion to reactiveui/ReactiveUI.Binding.SourceGenerators#179, which fixes reactiveui/ReactiveUI.Binding.SourceGenerators#175. The converter page currently describes the Single-only invariant exception that the code change removes.

Breaking changes

None in this documentation change. The companion code PR changes unhinted float formatting to use current culture.

How this was verified

Built the complete website with strict link checking and ran the quoted converter example. The documented output matches the example's French decimal separator.

Notes for the reviewer

Merge alongside or after reactiveui/ReactiveUI.Binding.SourceGenerators#179 so the published contract matches the runtime. Only the binding converter page changes.

Checklist

  • I have read the Contribute guide
  • The PR title follows Conventional Commits
  • Tests cover this change, or the summary says why they do not
  • New or changed public API has XML documentation

- Describe current culture for numeric defaults, hints, and nullable values.
- Quote the French float formatting example from the binding project.
- Explain how to supply an invariant conversion explicitly.
@glennawatson
glennawatson merged commit 0440100 into main Oct 13, 2026
4 checks passed
@glennawatson
glennawatson deleted the CP_docs-converter-culture branch October 13, 2026 03:43
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.

[Bug] Inconsistencies in the Expected Format Provider in Converters

3 participants