-
Notifications
You must be signed in to change notification settings - Fork 1.1k
Add user best practices documentation #5604
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
Add user best practices documentation #5604
Conversation
- Add document under 'start' about some basic best practices, like using 'cirq.X' instead of 'cirq.ops.X'. - Also added sections about immutability of gates, operations, and parameter resolvers. - Removed name of former product manager.
Check out this pull request on See visual diffs & provide feedback on Jupyter Notebooks. Powered by ReviewNB |
FYI: test failure is a complex64 related flake |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM, and a great addition. Thanks for writing this.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Some nits
docs/start/best_practices.md
Outdated
`cirq.ParamResolver` should not be modified after creation. If these objects | ||
need to be modified, a new object should be created instead. | ||
|
||
Violating this priniciple could cause problems in other parts of the code. For |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Violating this priniciple could cause problems in other parts of the code. For | |
Violating this principle could cause problems in other parts of the code. For |
Make `git diff --check master` happy.
Co-authored-by: Victory Omole <[email protected]>
Co-authored-by: Victory Omole <[email protected]>
Co-authored-by: Victory Omole <[email protected]>
@vtomole Hmmm... looks like there is some problem with your CLA that is now blocking the PR since I took your suggestions. |
LGTM. There is also a best_practices.ipynb notebook, |
Oh that's very new. Lemme look if i changed my default email. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't know if CLAs expire, but I just resigned it. LGTM
- Add document under 'start' about some basic best practices, like using 'cirq.X' instead of 'cirq.ops.X'. - Also added sections about immutability of gates, operations, and parameter resolvers. - Removed name of former product manager. Fixes: quantumlib#1373
like using 'cirq.X' instead of 'cirq.ops.X'.
parameter resolvers.
Fixes: #1373