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

Feature/update snarkyjs docs #917

Merged
merged 23 commits into from
May 25, 2023

Conversation

yunus433
Copy link
Contributor

@yunus433 yunus433 commented May 22, 2023

This PR adds useful developer-centric context, descriptions, and information

thank you @yunus433

Copy link
Contributor

@barriebyron barriebyron left a comment

Choose a reason for hiding this comment

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

these updates are so improved, good job @yunus433
Thank you for these valuable contributions.

My feedback is quite granular and editorial in nature. Questions? please ask

src/snarky.d.ts Outdated Show resolved Hide resolved
src/snarky.d.ts Outdated Show resolved Hide resolved
src/snarky.d.ts Outdated Show resolved Hide resolved
src/snarky.d.ts Outdated
*
* The field is the [pasta base field](https://electriccoin.co/blog/the-pasta-curves-for-halo-2-and-beyond/) of order 2^254 + 0x224698fc094cf91b992d30ed00000001 ({@link Field.ORDER}).
*
* You can create a new Field from everything "field-like" (`bigint`, integer, `number`, decimal, `string`, `Field`).
Copy link
Contributor

Choose a reason for hiding this comment

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

see earlier comment about code literals and whether we want single tick marks for only some of these "everything" items. Wherever we land, please make changes through for consistency

src/snarky.d.ts Outdated
* new Field("abc"); // ERROR: Invalid argument "abc"
* ```
*
* Creating a {@link Field} from a negative number may result in an unexpected behaviour if you are not familiar with [modular arithmatic](https://en.wikipedia.org/wiki/Modular_arithmetic).
Copy link
Contributor

Choose a reason for hiding this comment

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

Copy link
Member

Choose a reason for hiding this comment

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

Hey @barriebyron, I myself cannot tell what you mean here since you only link to a line of code. Maybe linking to an earlier PR comment would be clearer?

src/snarky.d.ts Outdated Show resolved Hide resolved
src/snarky.d.ts Outdated Show resolved Hide resolved
src/snarky.d.ts Outdated Show resolved Hide resolved
src/snarky.d.ts Outdated Show resolved Hide resolved
src/snarky.d.ts Outdated Show resolved Hide resolved
Copy link
Contributor

@barriebyron barriebyron left a comment

Choose a reason for hiding this comment

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

these updates are so improved, good job @yunus433
Thank you for these valuable contributions.

My feedback is quite granular and editorial in nature. Questions? please ask

Copy link
Contributor

@barriebyron barriebyron left a comment

Choose a reason for hiding this comment

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

these updates are so improved, good job @yunus433
Thank you for these valuable contributions.

My feedback is quite granular and editorial in nature. Questions? please ask

Copy link
Contributor

@barriebyron barriebyron left a comment

Choose a reason for hiding this comment

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

these updates are so improved, good job @yunus433
Thank you for these valuable contributions.

My feedback is quite granular and editorial in nature. Questions? please ask

@mitschabaude
Copy link
Member

Is there a reason you didn't use the old PR @yunus433?

yunus433 and others added 17 commits May 23, 2023 21:28
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Gregor Mitscha-Baude <gregor.mitscha-baude@gmx.at>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Co-authored-by: Barrie Byron <barrie@o1labs.org>
@yunus433
Copy link
Contributor Author

yunus433 commented May 23, 2023

these updates are so improved, good job @yunus433 Thank you for these valuable contributions.

My feedback is quite granular and editorial in nature. Questions?

Is there a reason you didn't use the old PR @yunus433?

I had an error on GitHub, and I thought that would fix it. But it didn't, I won't try this again :D

(I have done the same in the past! I understand)
For this reason, I really like smaller PRs and iterative contributions. I try to break out my docs into more manageable PRs.

thank you again!

@barriebyron barriebyron self-requested a review May 24, 2023 17:01
Copy link
Contributor

@barriebyron barriebyron left a comment

Choose a reason for hiding this comment

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

@yunus433 your contributions are very helpful, thank you! One tiny suggestion you can accept if you like

Thank you!!

src/snarky.d.ts Outdated Show resolved Hide resolved
Co-authored-by: Barrie Byron <barrie@o1labs.org>
Copy link
Member

@mitschabaude mitschabaude left a comment

Choose a reason for hiding this comment

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

awesome work @yunus433 🙌🏻

@mitschabaude
Copy link
Member

oh, @yunus433 I recommend you to merge this PR as soon as possible, because then I'll be able to move your improved doc comments to the new field implementation in this PR: #902

@yunus433
Copy link
Contributor Author

oh, @yunus433 I recommend you to merge this PR as soon as possible, because then I'll be able to move your improved doc comments to the new field implementation in this PR: #902

Hi @mitschabaude, I think now the merge issues are fixed, yet the PR needs a final review from @MartinMinkov to be merged. Thank you a lot :)

Copy link
Contributor

@MartinMinkov MartinMinkov left a comment

Choose a reason for hiding this comment

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

Awesome work Yunus! Feel free to merge!! 🥳

@yunus433
Copy link
Contributor Author

Hi @barriebyron, can you please merge the request? I cannot since I do not have a write permission on the repo. Thank you a lot :)

@MartinMinkov MartinMinkov merged commit e55c71d into o1-labs:main May 25, 2023
9 checks passed
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.

None yet

4 participants