Skip to content

docs: document the 2.0.0 BC breaks - #54

Merged
pekral merged 1 commit into
masterfrom
docs/upgrade-2.0
Nov 12, 2026
Merged

pekral merged 1 commit into
masterfrom
docs/upgrade-2.0

Conversation

@pekral

@pekral pekral commented Nov 12, 2026

Copy link
Copy Markdown
Collaborator

Closes #53

TL;DR

Dokumentace BC breaků pro verzi 2.0.0: návod pro přechod z 1.4 (UPGRADE-2.0.md) a changelog (CHANGELOG.md, záznam 2.0.0 bez data). Release se dělá ručně, tento PR žádný tag ani release nevytváří.

Změny

  • UPGRADE-2.0.md: každá změna veřejného API proti poslední vydané verzi 1.4 s ukázkou před/po:
    • požadavky na PHP a odstraněné závislosti,
    • new Client(new Config(...)) místo samostatných parametrů, $logFilePath → $debugMode,
    • Method jako nativní enum, SearchQueryOperator,
    • výjimky, ověřování TLS, timeouty, interní třídy.
  • CHANGELOG.md: BC breaky, novinky, opravy a závislosti. Mezi opravami jsou jen chyby, které byly ve vydané verzi 1.4. Chyby, které vznikly a opravily se mezi 1.4 a 2.0, tam nejsou.
  • README.md: odkaz na oba soubory a aktuální signatura callRequest() (původní ukázka měla tři parametry místo pěti).

Ověření

Každé tvrzení jsem porovnal se zdrojovým kódem tagu 1.4 (git show 1.4:…): konstruktor Client/Config s $logFilePath, Method a SearchQueryOperator dědící z Consistence\Enum\Enum, vypnuté TLS při authSessionId, json_encode() bez výjimky, chybějící timeouty a nekódovaný název firmy v restore URL.

Merge danger

  • Dveře: two-way, jen dokumentace.

Testování

  • composer check prochází (bez změny kódu).
  • Nové testy: ne, jde jen o dokumentaci.

Add UPGRADE-2.0.md with a before/after migration note for every public
API change since the last release (1.4), and CHANGELOG.md with the
unreleased 2.0.0 entry. The README links both and shows the current
callRequest() signature instead of an outdated one.

Closes #53
@pekral pekral added this to the 2.0.0 milestone Nov 12, 2026
@pekral
pekral marked this pull request as ready for review November 12, 2026 14:45
@pekral

pekral commented Nov 12, 2026

Copy link
Copy Markdown
Collaborator Author

Code Review

Status: clean
Counts: Critical 0 · Moderate 0 · Minor 0 · Refactoring 0
Last updated: 2026-11-12T14:45:28Z (head 76730c1)
Issue tracker summary: no linked issue summary posted — #53 is the source issue (documentation)


Summary: 0 Critical · 0 Moderate · 0 Minor · 0 Refactoring · assignment conformance: conformant (#53: UPGRADE-2.0.md covers every public API change since 1.4, CHANGELOG.md has the unreleased 2.0.0 entry, README links both) · reviewer comments: none

@pekral
pekral merged commit 2cd8502 into master Nov 12, 2026
4 checks passed
@pekral
pekral deleted the docs/upgrade-2.0 branch November 12, 2026 14:45
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.

Document the 2.0.0 BC breaks

1 participant