Skip to content

Conversation

@chowbao
Copy link
Contributor

@chowbao chowbao commented Oct 28, 2024

Update hubble e2e example to create visualization tutorial

  • Rename to Creating Visualizations Tutorial
  • Added final result gif/image and expectation at top of page
  • Updated images to be even clearer in what should be clicked/done

@stellar-jenkins
Copy link

Copy link
Contributor

@sydneynotthecity sydneynotthecity left a comment

Choose a reason for hiding this comment

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

I would also update the Create a Dashboard Analyzing Soroban Metrics to something like Create a Report in Looker Studio. That will give us the flexibility to either add sections for different tooling (Dune? python libraries? etc) while keeping the tutorial generic.

Also review Step #5 under Use Custom SQL... the markdown formatting is funky and blocks the incorrect words.

Lastly, should step #7 onward be its own section? Applying a Global Filter or something similar. These steps context switch without any transition which is confusing

@@ -1,8 +1,10 @@
---
title: "End to End Analysis Example"
title: "Creating Visualizations Tutorial"
Copy link
Contributor

Choose a reason for hiding this comment

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

nit: I would drop Tutorial

Maybe in future we add a Tutorials section this would go under

Copy link
Contributor Author

Choose a reason for hiding this comment

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

updated in c560544


By the end of the tutorial you will have created two graphs that will help visualize temporary VS persistent contract data entry distribution and expiration.

<img src={hubble_visualization_demo} width="1000" />
Copy link
Contributor

Choose a reason for hiding this comment

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

Love the gif, it really shows the end user how they can customize their visuals.
wdyt about dropping the hubble_visualization_final? it's kinda weird to me to include both at the top, feels duplicative

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hmm yeah I'll drop it

Copy link
Contributor Author

Choose a reason for hiding this comment

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

updated in c560544

<img src={hubble_visualization_demo} width="1000" />
<img src={hubble_visualization_final} width="500" />

As you can see, persistent contract data entries account for roughly 25% of all contract data entries with the rest being temporary. There are also a lot more expired temporary contract data entries. This is expected because temporay entries cannot be bumped whereas persistent entries can be bumped/restored. Please see [State Archival - Contract Data Type Descriptions](https://developers.stellar.org/docs/learn/encyclopedia/storage/state-archival#contract-data-type-descriptions) for more information.
Copy link
Contributor

Choose a reason for hiding this comment

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

nit: I would reword the last sentence:

For more information, you can read about [State Archival and the Contract Data Lifecycle].

Copy link
Contributor Author

Choose a reason for hiding this comment

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

updated in c560544

:::note

Note that between `2024-02-01` and `2024-06-30` there aren't that many expired persistent entries
Note that between `2024-02-01` and `2024-10-31` there aren't that many expired persistent entries
Copy link
Contributor

Choose a reason for hiding this comment

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

Why does this matter? Curious what we're trying to highlight with the note

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I was trying to warn that the differences between temp and persistent expiration is pretty large. But yeah that point isn't necessary for this tutorial

Copy link
Contributor Author

Choose a reason for hiding this comment

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

updated in c560544

@stellar-jenkins
Copy link

@chowbao chowbao merged commit 7507c1f into main Oct 31, 2024
@chowbao chowbao deleted the update-hubble-e2e-examples branch October 31, 2024 19:23
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.

4 participants