Skip to content

Conversation

@lolosaisa
Copy link

This PR adds a rough structure for the SSZ documentation targeted at TypeScript developers, in reference to #5045.

What's included

  • Created /packages/types/docs/ directory to hold new SSZ usage documentation
  • Added placeholder files for:
    • ssz-quickstart.md – Quickstart on serialize/deserialize/hashTreeRoot
    • ssz-views-and-proofs.md – Overview of views and merkle proofs
  • Introduced per-phase folders and files for documenting specific SSZ types:
    • phase0/Attestation.md, BeaconBlock.md, Validator.md
    • altair/SyncCommittee.md
    • bellatrix/ExecutionPayload.md
  • Draft README.md outlining the purpose and structure of the documentation

Purpose

This PR is intended to:

  • Propose a clean and scalable folder/file structure for upcoming documentation
  • Demonstrate commitment to the issue
  • Invite feedback and approval from maintainers before continuing with full content development

Full examples and in-depth code explanations will be added in follow-up PRs once this structure is reviewed and accepted.


…older structure and markdown files to document SSZ types and utilities. This will serve as a reference for contributors and developers working with Lodestar’s SSZ types
@lolosaisa lolosaisa requested a review from a team as a code owner July 23, 2025 18:46
@CLAassistant
Copy link

CLAassistant commented Jul 23, 2025

CLA assistant check
All committers have signed the CLA.

@lolosaisa lolosaisa changed the title Add SSZ usage documentation for TypeScript devs issue(#5045) docs: Add SSZ usage documentation for TypeScript devs issue(#5045) Jul 24, 2025
@lolosaisa lolosaisa changed the title docs: Add SSZ usage documentation for TypeScript devs issue(#5045) docs: added SSZ usage documentation for TypeScript devs issue(#5045) Jul 24, 2025
@lolosaisa lolosaisa marked this pull request as draft July 24, 2025 20:41
@codecov
Copy link

codecov bot commented Jul 25, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 52.19%. Comparing base (d50b3b7) to head (f583522).
⚠️ Report is 357 commits behind head on unstable.

Additional details and impacted files
@@             Coverage Diff              @@
##           unstable    #8078      +/-   ##
============================================
- Coverage     55.72%   52.19%   -3.53%     
============================================
  Files           834      852      +18     
  Lines         59754    65054    +5300     
  Branches       4611     4773     +162     
============================================
+ Hits          33299    33958     +659     
- Misses        26386    31027    +4641     
  Partials         69       69              
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

lolosaisa added 20 commits July 26, 2025 14:33
…as and made a few changes on the styling and arrangement of the docs
… real life example and defination of attestation
…fety is implemented and why it matters in the Ethereum Development
…les decided to make the example.md file Having one centralized examples file makes it easy for developers
@lolosaisa lolosaisa changed the title docs: added SSZ usage documentation for TypeScript devs issue(#5045) docs: finalize SSZ usage documentation for TypeScript devs (Issue #5045) Oct 10, 2025
@lolosaisa
Copy link
Author

This PR completes the SSZ documentation targeted at TypeScript developers.

What's New

  • Finalized README.md explaining the documentation purpose and structure
  • Added ssz-quickstart.md — beginner-friendly introduction to SSZ
  • Added ssz-views-and-proofs.md — advanced guide on tree-backed views and proofs
  • Included runnable TypeScript examples and detailed explanations in the ssz-examples.md
  • Improved clarity, fixed broken links, and standardized file structure
    Ready for review

@lolosaisa lolosaisa marked this pull request as ready for review October 10, 2025 10:04
@lolosaisa lolosaisa changed the title docs: finalize SSZ usage documentation for TypeScript devs (Issue #5045) docs: finalize SSZ usage documentation for TypeScript devs (Issue #5045) Oct 10, 2025
@philknows
Copy link
Member

Please lint your work @lolosaisa and thoroughly read the contributor's document to help make CI pass before review, thanks.

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.

3 participants