From 6df074663633dcae95636119f5e60ae47c6ce054 Mon Sep 17 00:00:00 2001 From: Jay Gambetta Date: Wed, 26 Dec 2018 16:56:21 -0500 Subject: [PATCH 1/4] Making the readme the same --- .github/CONTRIBUTING.rst | 16 ++++++++++++++++ README.md | 29 +++++++++++++++-------------- 2 files changed, 31 insertions(+), 14 deletions(-) create mode 100644 .github/CONTRIBUTING.rst diff --git a/.github/CONTRIBUTING.rst b/.github/CONTRIBUTING.rst new file mode 100644 index 000000000..0d87130a3 --- /dev/null +++ b/.github/CONTRIBUTING.rst @@ -0,0 +1,16 @@ +Contributing +=============== +If you would like to contribute to the tutorials, there are a number of ways to +get involved: + +* **Issues**: Issues can be reported with GitHub [issue +reporting](https://github.com/Qiskit/qiskit-tutorial/issues) for this repository. +Select `New issue`, fill in a descriptive title, and provide as much detail +as is needed for the issue to be reproduced. + +* **Notebooks**: If you would like to contribute a notebook, please +create a [fork](https://help.github.com/articles/fork-a-repo/) of the repository +from the `master` branch and create a +[pull request](https://help.github.com/articles/about-pull-requests/) for your change. + Note that new notebooks should be placed in the relevant part of the +`Community `_ section. \ No newline at end of file diff --git a/README.md b/README.md index 5b3bf6ade..fb7536d1c 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,3 @@ - - - -*** - - # Qiskit Tutorials [![License](https://img.shields.io/github/license/Qiskit/qiskit-tutorials.svg?style=popout-square)](https://opensource.org/licenses/Apache-2.0) [![Binder](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/QISKit/qiskit-tutorial/master?filepath=index.ipynb) @@ -45,16 +39,23 @@ Teaching quantum computing and qiskit has many different paths of learning. We l To go through the tutorials, load up the [index.ipynb](index.ipynb) notebook and start learning. -*** +## Contribution guidelines + +If you'd like to contribute to Qiskit, please take a look at our +[contribution guidelines](.github/CONTRIBUTING.rst). This project adheres to Qiskit's [code of conduct](.github/CODE_OF_CONDUCT.rst). By participating, you are expect to uphold to this code. + +We use [GitHub issues](https://github.com/Qiskit/qiskit-terra/issues) for tracking requests and bugs. Please use our [slack](https://qiskit.slack.com) for discussion and simple questions. To join our Slack community use the [link](https://join.slack.com/t/qiskit/shared_invite/enQtNDc2NjUzMjE4Mzc0LTMwZmE0YTM4ZThiNGJmODkzN2Y2NTNlMDIwYWNjYzA2ZmM1YTRlZGQ3OGM0NjcwMjZkZGE0MTA4MGQ1ZTVmYzk). For questions that are more suited for a forum we use the Qiskit tag in the [Stack Overflow](https://stackoverflow.com/questions/tagged/qiskit). -## Contributing -If you would like to contribute to the tutorials, there are a number of ways to get involved: +### Next Steps -* **Issues**: Issues can be reported with GitHub [issue reporting](https://github.com/Qiskit/qiskit-tutorial/issues) for this repository. Select `New issue`, fill in a descriptive title, and provide as much detail as is needed for the issue to be reproduced. -* **Notebooks**: If you would like to contribute a notebook, please create a [fork](https://help.github.com/articles/fork-a-repo/) of the repository from the `master` branch and create a [pull request](https://help.github.com/articles/about-pull-requests/) for your change. Note that new notebooks should be placed in the relevant part of the [Community](community/) section. +Now you're set up and ready to check out some of the other examples from our +[Qiskit Tutorial](https://github.com/Qiskit/qiskit-tutorial) repository. -## Contributors -These tutorials are the work of our [Qiskitters](https://github.com/Qiskit/qiskit-tutorial/graphs/contributors) who contribute to the project at different levels. +## Authors + +Qiskit Terra is the work of [many people](https://github.com/Qiskit/qiskit-terra/graphs/contributors) who contribute +to the project at different levels. ## License -This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/QISKit/qiskit-tutorial/blob/master/LICENSE) file for details. + +[Apache License 2.0](LICENSE.txt) From f308014f480107a8347ca9ef3a407fd40385df8a Mon Sep 17 00:00:00 2001 From: Jay Gambetta Date: Wed, 26 Dec 2018 16:59:23 -0500 Subject: [PATCH 2/4] Linting --- .github/CONTRIBUTING.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/.github/CONTRIBUTING.rst b/.github/CONTRIBUTING.rst index 0d87130a3..1e574f77f 100644 --- a/.github/CONTRIBUTING.rst +++ b/.github/CONTRIBUTING.rst @@ -3,14 +3,14 @@ Contributing If you would like to contribute to the tutorials, there are a number of ways to get involved: -* **Issues**: Issues can be reported with GitHub [issue -reporting](https://github.com/Qiskit/qiskit-tutorial/issues) for this repository. +* **Issues**: Issues can be reported with GitHub `issue +reporting `_ for this repository. Select `New issue`, fill in a descriptive title, and provide as much detail as is needed for the issue to be reproduced. * **Notebooks**: If you would like to contribute a notebook, please -create a [fork](https://help.github.com/articles/fork-a-repo/) of the repository +create a `fork `_ of the repository from the `master` branch and create a -[pull request](https://help.github.com/articles/about-pull-requests/) for your change. - Note that new notebooks should be placed in the relevant part of the +`pull requests `_ for your change. +Note that new notebooks should be placed in the relevant part of the `Community `_ section. \ No newline at end of file From bb891f017c806e25f016a91536431a0333b6911c Mon Sep 17 00:00:00 2001 From: Jay Gambetta Date: Wed, 26 Dec 2018 17:00:56 -0500 Subject: [PATCH 3/4] lint --- .github/CONTRIBUTING.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/.github/CONTRIBUTING.rst b/.github/CONTRIBUTING.rst index 1e574f77f..6cbe4bc37 100644 --- a/.github/CONTRIBUTING.rst +++ b/.github/CONTRIBUTING.rst @@ -4,13 +4,13 @@ If you would like to contribute to the tutorials, there are a number of ways to get involved: * **Issues**: Issues can be reported with GitHub `issue -reporting `_ for this repository. -Select `New issue`, fill in a descriptive title, and provide as much detail -as is needed for the issue to be reproduced. + reporting `_ for this repository. + Select `New issue`, fill in a descriptive title, and provide as much detail + as is needed for the issue to be reproduced. * **Notebooks**: If you would like to contribute a notebook, please -create a `fork `_ of the repository -from the `master` branch and create a -`pull requests `_ for your change. -Note that new notebooks should be placed in the relevant part of the -`Community `_ section. \ No newline at end of file + create a `fork `_ of the repository + from the `master` branch and create a + `pull requests `_ for your change. + Note that new notebooks should be placed in the relevant part of the + `Community `_ section. \ No newline at end of file From 2d8d17c6202561974913b4d1fdcc96a3cf7bd561 Mon Sep 17 00:00:00 2001 From: Jay Gambetta Date: Wed, 26 Dec 2018 19:48:50 -0500 Subject: [PATCH 4/4] Updating readme and contribute --- .github/CONTRIBUTING.rst | 22 ++++++++++++++++++++-- README.md | 21 ++++++++------------- 2 files changed, 28 insertions(+), 15 deletions(-) diff --git a/.github/CONTRIBUTING.rst b/.github/CONTRIBUTING.rst index 6cbe4bc37..5ac6b0433 100644 --- a/.github/CONTRIBUTING.rst +++ b/.github/CONTRIBUTING.rst @@ -1,6 +1,7 @@ Contributing =============== -If you would like to contribute to the tutorials, there are a number of ways to + +If you would like to contribute to the Qiskit-tutorials, there are a number of ways to get involved: * **Issues**: Issues can be reported with GitHub `issue @@ -13,4 +14,21 @@ get involved: from the `master` branch and create a `pull requests `_ for your change. Note that new notebooks should be placed in the relevant part of the - `Community `_ section. \ No newline at end of file + `Community <./community/>`_ section. + +Contributor License Agreement +----------------------------- + +We'd love to accept your code! Before we can, we have to get a few legal +requirements sorted out. By signing a contributor license agreement (CLA), we +ensure that the community is free to use your contributions. + +When you contribute to the Qiskit Terra project with a new pull request, a bot will +evaluate whether you have signed the CLA. If required, the bot will comment on +the pull request, including a link to accept the agreement. The +`individual CLA `_ document is +available for review as a PDF. + +NOTE: If you work for a company that wants to allow you to contribute your work, +then you'll need to sign a `corporate CLA `_ +and email it to us at qiskit@us.ibm.com. diff --git a/README.md b/README.md index fb7536d1c..545baae02 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,12 @@ # Qiskit Tutorials -[![License](https://img.shields.io/github/license/Qiskit/qiskit-tutorials.svg?style=popout-square)](https://opensource.org/licenses/Apache-2.0) -[![Binder](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/QISKit/qiskit-tutorial/master?filepath=index.ipynb) +[![License](https://img.shields.io/github/license/Qiskit/qiskit-tutorials.svg?style=popout-square)](https://opensource.org/licenses/Apache-2.0)![](https://img.shields.io/github/release/Qiskit/qiskit-tutorials.svg?style=popout-square)![](https://img.shields.io/github/downloads/Qiskit/qiskit-tutorials/total.svg?style=popout-square) Welcome to the [Qiskit](https://www.qiskit.org/) tutorials! In this repository, we've put together a collection of Jupyter notebooks aimed at teaching people who want to use Qiskit for writing quantum computing programs, and executing them on one of several backends (online quantum processors, online simulators, and local simulators). The online quantum processors are the [IBM Q](https://quantumexperience.ng.bluemix.net/qx/devices) devices. -## Installation and Setup +## Installation The notebooks for these tutorials can be viewed here on GitHub. But for the full experience, you'll want to interact with them! @@ -15,12 +14,12 @@ The easiest way to do this is using [the Binder image](https://mybinder.org/v2/g Please refer to this [installation guide](INSTALL.md) for setting up Qiskit and the tutorials on your own machine (this is the recommended way). -*** - ## Contents + We have organized the tutorials into two sections: ### 1. [Qiskit notebooks](qiskit/) + We've collected a core reference set of notebooks in this section outlining the features of Qiskit. We will be keeping them up to date with the latest Qiskit version. - [Basics](qiskit/basics) is meant for those who are getting started. - [Terra](qiskit/terra) is meant for those who want to study circuits. @@ -29,6 +28,7 @@ We've collected a core reference set of notebooks in this section outlining the - [Jupyter](qiskit/jupyter) is meant to highlight some cool Juypter features. ### 2. [Community notebooks](community/) + Teaching quantum computing and qiskit has many different paths of learning. We love our community, and we love the contributions so keep them coming. Because Qiskit is changing so much, at the moment we cant keep this updated, but there are some great notebooks in here. See: - [Hello, Quantum World](community/hello_world/) learn from the community how to write your first quantum program. - [Quantum Games](community/games/), learn quantum computing by having fun. @@ -41,19 +41,14 @@ To go through the tutorials, load up the [index.ipynb](index.ipynb) notebook and ## Contribution guidelines -If you'd like to contribute to Qiskit, please take a look at our +If you'd like to contribute to Qiskit Tutorials, please take a look at our [contribution guidelines](.github/CONTRIBUTING.rst). This project adheres to Qiskit's [code of conduct](.github/CODE_OF_CONDUCT.rst). By participating, you are expect to uphold to this code. -We use [GitHub issues](https://github.com/Qiskit/qiskit-terra/issues) for tracking requests and bugs. Please use our [slack](https://qiskit.slack.com) for discussion and simple questions. To join our Slack community use the [link](https://join.slack.com/t/qiskit/shared_invite/enQtNDc2NjUzMjE4Mzc0LTMwZmE0YTM4ZThiNGJmODkzN2Y2NTNlMDIwYWNjYzA2ZmM1YTRlZGQ3OGM0NjcwMjZkZGE0MTA4MGQ1ZTVmYzk). For questions that are more suited for a forum we use the Qiskit tag in the [Stack Overflow](https://stackoverflow.com/questions/tagged/qiskit). - -### Next Steps - -Now you're set up and ready to check out some of the other examples from our -[Qiskit Tutorial](https://github.com/Qiskit/qiskit-tutorial) repository. +We use [GitHub issues](https://github.com/Qiskit/qiskit-tutorials/issues) for tracking requests and bugs. Please use our [slack](https://qiskit.slack.com) for discussion and simple questions. To join our Slack community use the [link](https://join.slack.com/t/qiskit/shared_invite/enQtNDc2NjUzMjE4Mzc0LTMwZmE0YTM4ZThiNGJmODkzN2Y2NTNlMDIwYWNjYzA2ZmM1YTRlZGQ3OGM0NjcwMjZkZGE0MTA4MGQ1ZTVmYzk). For questions that are more suited for a forum we use the Qiskit tag in the [Stack Overflow](https://stackoverflow.com/questions/tagged/qiskit). ## Authors -Qiskit Terra is the work of [many people](https://github.com/Qiskit/qiskit-terra/graphs/contributors) who contribute +Qiskit Terra is the work of [many people](https://github.com/Qiskit/qiskit-tutorials/graphs/contributors) who contribute to the project at different levels. ## License