Skip to content

Conversation

@trokhim03
Copy link

@trokhim03 trokhim03 commented Jan 11, 2026

Documentation quality & consistency improvements

Changes overview:

  • Fixed typo in chain operators best practices guide
  • Standardized SPDX license identifier formatting (missing space)
  • Updated all tutorial Solidity contract files (11 files) to use ^0.8.33
  • Updated pragma statements in documentation code blocks (6 instances across 4 .mdx files)
  • Updated outdated Solidity documentation links (v0.8.19 → v0.8.33, v0.8.23 → v0.8.33)
  • Updated old compiler version mention in tutorial (0.8.15 → 0.8.33)

Impact:

  • 22 files touched
  • ~35 individual fixes
  • 5 small, focused, review-friendly commits

All changes are purely documentation-related, no logic/behavior impact expected.

Review focus:

  • Confirm new pragma ^0.8.33 still makes sense for all examples
  • Quick visual check of code blocks in rendered docs

Why ^0.8.33?
As of January 2026, Solidity 0.8.33 (released Dec 18, 2025) is the latest stable version in the 0.8.x series.

Key reasons:

  • It includes critical bugfixes from 0.8.32 (storage array write loss on slot overflow + hotfix for constant getters ICE)
  • Only the latest patch receives security updates
  • All tutorial examples compile cleanly with no breaking changes
  • Ensures consistency, modern compiler recommendations, and future patch compatibility (^0.8.33 → <0.9.0)

This update keeps our docs accurate, secure, and aligned with current best practices.

Fix typo "This is will be" to "This will be" in chain operators
best practices documentation.
Update all Solidity pragma statements in tutorial contract files
to use ^0.8.33, ensuring consistency with current best practices
and latest compiler version recommendations.
Add missing space in SPDX license identifiers to match standard
format (// SPDX-License-Identifier: MIT).
Update all Solidity pragma statements in tutorial documentation
(.mdx files) to use ^0.8.33 for consistency with contract files.
…nces

Update links to Solidity documentation from v0.8.19 and v0.8.23
to v0.8.33, and update tutorial mention of compiler version
from 0.8.15 to 0.8.33 for accuracy.
@trokhim03 trokhim03 changed the title Docs/solidity version update 2026 docs/solidity version update 2026 Jan 11, 2026
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