Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: pimp out readme with blob lifecycle diagrams #233

Merged
merged 13 commits into from
Jan 23, 2025

Conversation

samlaf
Copy link
Collaborator

@samlaf samlaf commented Jan 10, 2025

We have a full spec coming so perhaps some of the stuff here will be redundant and we can remove it and just point to the spec once it's ready. But in the meantime I think it's good to have more (rather than less) info.

Main changes include:

  • moving some sections around in the README (eg: moving flags all the way to bottom instead of top)
  • adding a table of content
  • new blob lifecycle section with diagrams
  • some changes to nomenclature in commitment schemas section to match our recent understanding
  • rename raw_commitment -> payload in README and routing/handlers code

Fixes Issue

Fixes #

Changes proposed

Screenshots (Optional)

Note to reviewers

@samlaf samlaf marked this pull request as draft January 10, 2025 04:19
@samlaf samlaf marked this pull request as ready for review January 22, 2025 03:12
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
Posting Blobs -> Posting Payloads
Retrieving Blobs -> Retrieving Payloads
@samlaf samlaf requested a review from litt3 January 23, 2025 16:31
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice chart

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you want to use the updated the chart, Austin and us draw yesterday

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good call! sorry merged this PR before seeing your comment. Created #256 to change the image

Add some intro section, and add links to Integration Guide
@samlaf samlaf merged commit ad8ad21 into main Jan 23, 2025
8 checks passed
@samlaf samlaf deleted the samlaf/pimp-out-readme-with-blob-lifecycle-diagrams branch January 23, 2025 19:18
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