Skip to content

docs: fix stale compression references after v1.9.8 - #347

Merged
MPCoreDeveloper merged 1 commit into
MPCoreDeveloper:masterfrom
saltus7:docs/fix-stale-compression-references
Aug 30, 2026
Merged

docs: fix stale compression references after v1.9.8#347
MPCoreDeveloper merged 1 commit into
MPCoreDeveloper:masterfrom
saltus7:docs/fix-stale-compression-references

Conversation

@saltus7

@saltus7 saltus7 commented Aug 30, 2026

Copy link
Copy Markdown
Collaborator

Summary

Updates documentation and code comments that still described block compression as "not implemented" or "reserved" despite being shipped in v1.9.8 (PR #344).

Changes

  • docs/serialization/SERIALIZATION_AND_STORAGE_GUIDE.md — Updated compression table row and header field comment
  • docs/serialization/BINARY_FORMAT_VISUAL_REFERENCE.md — Updated CompressionMode field description
  • src/SharpCoreDB/Storage/Scdb/ScdbStructures.cs — Updated CompressionMode field XML doc and inline comment; updated BlockFlags.Compressed enum doc
  • .github/CODING_STANDARDS_CSHARP14.md — Updated stale TODO to reflect remaining streaming-compression work

Context

These references were left stale after PR #344 merged block-level Brotli/GZip compression. This PR cleans up the documentation to match the shipped feature.

Updates documentation and code comments that still described block
compression as 'not implemented' or 'reserved' despite being shipped
in v1.9.8 (PR MPCoreDeveloper#344).
@sonarqubecloud

Copy link
Copy Markdown

@saltus7

saltus7 commented Aug 30, 2026

Copy link
Copy Markdown
Collaborator Author

The CI failure appears unrelated to this PR. These are documentation and comment-only changes (3 markdown files + XML doc comments in one .cs file) that don't affect compiled code or test behavior.

The XML warnings shown in the logs point to DatabaseExtensions.cs and Database.PerformanceOptimizations.cs, which are not modified by this PR.

Happy to help investigate if needed, but this looks like either a flaky test or a pre-existing issue on master.

@MPCoreDeveloper
MPCoreDeveloper merged commit de79128 into MPCoreDeveloper:master Aug 30, 2026
6 of 7 checks passed
MPCoreDeveloper pushed a commit that referenced this pull request Aug 30, 2026
…ionMode comments after #347

PR #347 updated compression references but (1) replaced the standard <copyright> header line with a bare file path (leaving a dangling </copyright>), and (2) documented the ScdbFileHeader.CompressionMode byte as 0=None/1=Brotli/2=GZip even though the byte is never written (always 0) - the mode is supplied via DatabaseOptions.BlockCompression and per-block state is the Compressed flag.
@MPCoreDeveloper

Copy link
Copy Markdown
Owner

I see often 'problems' with the CLI runners , as they are not always fast enough for some tests i have to 'tweak' them or simply run them again and then they magically work .

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.

2 participants