From 33120ba7e157140cfbe87ae8040f587298f3b919 Mon Sep 17 00:00:00 2001
From: mahach666 <79989386+mahach666@users.noreply.github.com>
Date: Fri, 13 Nov 2026 04:08:39 +0300
Subject: [PATCH] Recommend a range for IOScene that nuget.org accepts
nuget.org refuses a dependency bound such as 0.2.0-0: a bound with one
prerelease label is checked by its legacy rule, under which the label must
start with a letter. The release of IfcIO.Scene 0.11.0 failed on it. The README
and section 5 of the contract now recommend [0.N.0, 0.N+1.0-0.0): two labels
make the bound SemVer 2.0, and it keeps out every preview of the next line
except 0.2.0-0, which IOScene does not publish. The key registry fixes the ifc:
formats from IfcIO.Scene 0.11.1, its first release, and the changelog preamble
says that a patch adds or fixes, as the contract does.
---
CHANGELOG.md | 9 ++++++++-
README.md | 11 ++++++-----
docs/contract.md | 4 ++--
docs/keys.md | 2 +-
4 files changed, 17 insertions(+), 9 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 533dba7..389cc5f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,10 +2,17 @@
All notable changes are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
and the project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html) with one rule for versions before
-1.0: a patch release is additive, and a minor release may break the API and the file format.
+1.0: a patch release adds or fixes, and a minor release may break the API and the file format.
## [Unreleased]
+### Fixed
+- README and `docs/contract.md`: a package that depends on IOScene references `[0.N.0, 0.N+1.0-0.0)` instead of
+ `[0.N.0, 0.N+1.0-0)`. nuget.org refuses a package whose dependency bound is `0.2.0-0`, because a prerelease label of
+ one part must start with a letter there; `0.2.0-0.0` has two parts and keeps out every preview of 0.2.0 except
+ `0.2.0-0`, which IOScene does not publish.
+- `docs/keys.md`: the `ifc:` formats are fixed from `IfcIO.Scene` 0.11.1, its first release; nuget.org refused 0.11.0.
+
## [0.1.0] - 2026-11-13
First stable release. The API, the file format (kind `ioscene`, format 1) and the validation codes are those of
diff --git a/README.md b/README.md
index 41cd95b..3f0b364 100644
--- a/README.md
+++ b/README.md
@@ -40,15 +40,16 @@ dotnet add package IOScene
```
A package that depends on IOScene references one 0.x line, because a 0.x minor release may break the API and a patch
-release never does. For the line 0.N the range is `[0.N.0, 0.N+1.0-0)`; the `-0` keeps out the previews of the next
-line:
+release never does. For the line 0.N the range is `[0.N.0, 0.N+1.0-0.0)`; the `-0.0` keeps out the previews of the
+next line:
```xml
-
+
```
-`dotnet pack` of a stable package reports NU5104 for this range, because its upper bound `0.2.0-0` is a prerelease
-version; add `$(NoWarn);NU5104` to the referencing project.
+`dotnet pack` of a stable package reports NU5104 for this range, because its upper bound `0.2.0-0.0` is a prerelease
+version; add `$(NoWarn);NU5104` to the referencing project. The bound has two labels because
+nuget.org refuses a dependency bound such as `0.2.0-0`, whose one prerelease label does not start with a letter.
## Quick start
diff --git a/docs/contract.md b/docs/contract.md
index 32af567..f7754c7 100644
--- a/docs/contract.md
+++ b/docs/contract.md
@@ -245,8 +245,8 @@ The reader keeps enum numbers it does not know, and writes them back.
### Versions
In 0.x a patch release is additive or fixes a defect, and a minor release is breaking. A package that depends on
-`IOScene` 0.N references the range `[0.N.0, 0.N+1.0-0)`; the `-0` keeps out the previews of the next breaking line.
-From 1.0 the range is `[1.M.0, 2.0.0-0)`.
+`IOScene` 0.N references the range `[0.N.0, 0.N+1.0-0.0)`; the `-0.0` keeps out the previews of the next breaking
+line (nuget.org refuses the shorter bound `-0` in a dependency). From 1.0 the range is `[1.M.0, 2.0.0-0.0)`.
## 6. Names
diff --git a/docs/keys.md b/docs/keys.md
index 751847a..1732986 100644
--- a/docs/keys.md
+++ b/docs/keys.md
@@ -30,7 +30,7 @@ This file is the registry of the namespaces, of their key formats and of the `Sc
| Namespace | Owner package | Status |
|---|---|---|
| `revit:` | `RvtIO.Scene` | registered; the formats below are fixed from the first release of the package, 0.4.0 |
-| `ifc:` | `IfcIO.Scene` | registered; the formats below are fixed from the first release of the package, 0.11.0 |
+| `ifc:` | `IfcIO.Scene` | registered; the formats below are fixed from the first release of the package, 0.11.1 |
No other namespace is registered. Producers for NWC, DWG and other formats register theirs when they are written.