Skip to content

Improve docs on private Witness fields#2930

Merged
apoelstra merged 1 commit intorust-bitcoin:masterfrom
tcharding:06-27-witness-docs
Jun 30, 2024
Merged

Improve docs on private Witness fields#2930
apoelstra merged 1 commit intorust-bitcoin:masterfrom
tcharding:06-27-witness-docs

Conversation

@tcharding
Copy link
Copy Markdown
Member

The Witness type is a reasonable complex data structure, make an effort to clarify its structure in the docs on the private fields.

Private docs only.

(Original idea pulled out of #2133.)

@tcharding tcharding changed the title Improve docs on private Witness fields Improve docs on private Witness fields Jun 27, 2024
@github-actions github-actions bot added the C-bitcoin PRs modifying the bitcoin crate label Jun 27, 2024
Copy link
Copy Markdown
Collaborator

@Kixunil Kixunil left a comment

Choose a reason for hiding this comment

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

Concept ACK

@tcharding
Copy link
Copy Markdown
Member Author

Thanks for review, will use

@tcharding tcharding force-pushed the 06-27-witness-docs branch from 5d422f3 to 4d97a15 Compare June 28, 2024 20:43
@tcharding
Copy link
Copy Markdown
Member Author

Used your suggestions @Kixunil except I used "Said another way," instead of "IOW"

The `Witness` type is a reasonable complex data structure, make an
effort to clarify its structure in the docs on the private fields.

Private docs only.
@tcharding tcharding force-pushed the 06-27-witness-docs branch from 4d97a15 to c717f7f Compare June 29, 2024 20:05
@tcharding
Copy link
Copy Markdown
Member Author

Fixed, thanks.

Copy link
Copy Markdown
Collaborator

@Kixunil Kixunil left a comment

Choose a reason for hiding this comment

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

ACK c717f7f

Copy link
Copy Markdown
Member

@apoelstra apoelstra left a comment

Choose a reason for hiding this comment

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

ACK c717f7f much clearer, thanks!

@apoelstra apoelstra merged commit 45e311c into rust-bitcoin:master Jun 30, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

C-bitcoin PRs modifying the bitcoin crate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants