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

Fix a few mistakes in the Penumbra Protocol docs #3710

Merged
merged 5 commits into from
Jan 31, 2024
Merged

Conversation

jessepinho
Copy link
Contributor

@jessepinho jessepinho commented Jan 31, 2024

Just a couple things I noticed while reading the Penumbra protocol.

Just noticed this while reading the Penumbra protocol.

Signed-off-by: Jesse Pinho <jesse@jessepinho.com>
@jessepinho jessepinho marked this pull request as ready for review January 31, 2024 03:31
Signed-off-by: Jesse Pinho <jesse@jessepinho.com>
@jessepinho jessepinho changed the title Fix repeated language in Transactions docs Fix language in Transactions docs Jan 31, 2024
@jessepinho jessepinho changed the title Fix language in Transactions docs Fix a few mistakes in the Penumbra Protocol docs Jan 31, 2024
Signed-off-by: Jesse Pinho <jesse@jessepinho.com>
Signed-off-by: Jesse Pinho <jesse@jessepinho.com>
@@ -62,5 +62,4 @@ addresses, allowing fine-grained control of delegation.

This diagram shows only the user-visible parts of the key hierarchy.
Internally, each of these keys has different components, described in detail in
the [Addresses and Keys](../protocol/addresses_keys.md) section of the
[Cryptographic Protocol](../protocol.md) chapter.
the [Addresses and Keys](../protocol/addresses_keys.md) chapter.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Addresses and Keys is now its own chapter, rather than being under the Cryptographic Protocol chapter.

@@ -61,7 +61,7 @@ description leaves the value balance unchanged.
transaction's value balance, burning them, and producing a swap commitment for
use in the second stage;

- **Sweep** descriptions perform the second phase of
- **SwapClaim** descriptions perform the second phase of
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Reviewers: please confirm that this change is correct.

Copy link
Member

Choose a reason for hiding this comment

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

Yep! Another terminology change we didn't update

Comment on lines 38 to 40
- **Commission** descriptions are used by validators to [claim commission on
staking rewards](../stake/validator-rewards.md) into shielded notes,
adding unbonded stake to the transaction's value balance;
Copy link
Member

Choose a reason for hiding this comment

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

We actually got rid of these entirely, now the commission is paid out by the chain, so we could delete this bullet point.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Got it — removed.

Copy link
Member

@hdevalence hdevalence left a comment

Choose a reason for hiding this comment

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

LGTM! Thanks for flagging this stuff, the spec has drifted a bit as we've focused on the protocol.

Signed-off-by: Jesse Pinho <jesse@jessepinho.com>
@hdevalence hdevalence merged commit 2221fb7 into main Jan 31, 2024
7 checks passed
@hdevalence hdevalence deleted the jessepinho-patch-1 branch January 31, 2024 06:40
TalDerei pushed a commit that referenced this pull request Feb 8, 2024
* Fix repeated language in Transactions docs

Just noticed this while reading the Penumbra protocol.

Signed-off-by: Jesse Pinho <jesse@jessepinho.com>

* Fix reference to SwapClaims

Signed-off-by: Jesse Pinho <jesse@jessepinho.com>

* Fix references to addresses + keys chapter

Signed-off-by: Jesse Pinho <jesse@jessepinho.com>

* Remove reference to addresses + keys, which is now in its own chapter

Signed-off-by: Jesse Pinho <jesse@jessepinho.com>

* Remove outdated bullet point

Signed-off-by: Jesse Pinho <jesse@jessepinho.com>

---------

Signed-off-by: Jesse Pinho <jesse@jessepinho.com>
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