Skip to content

Commit 8dad0c3

Browse files
authored
Merge pull request #31 from qsharp-community/v2.0
V2.0 ๐ŸŽ‚
2 parents 974b343 + 508e2d5 commit 8dad0c3

File tree

13 files changed

+176
-58
lines changed

13 files changed

+176
-58
lines changed

โ€ŽREADME.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
1-
# Welcome to the Q# Community!
1+
# ๐Ÿ‘‹ Welcome to the Q# Community!
22

3-
[![Gitter](https://badges.gitter.im/qsharp-community/community.svg)](https://gitter.im/qsharp-community/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
3+
[![CoC](https://img.shields.io/badge/Q%23%20Community-Code%20of%20Conduct-%233b9cba?color=409ae1&)](https://qsharp.community/coc)
4+
[![Discord](https://img.shields.io/discord/724763240751562794?color=409ae1&logo=Discord)](https://discord.qsharp.community)
5+
[![Twitter](https://img.shields.io/twitter/follow/qsharpcommunity?color=409ae1&logo=twitter&style=flat)](https://twitter.com/qsharpcommunity)
46

5-
This group collects + maintains projects related to the [Q# programming language](https://docs.microsoft.com/quantum) by a community of folks who are excited about quantum programming! ๐Ÿ˜Š
7+
The Q# Community collects + maintains projects related to the [Q# programming language](https://docs.microsoft.com/quantum) by a community of folks who are excited about quantum programming!
68

79
> Check out our webpage at [qsharp.community](https://qsharp.community)
810
9-
## Adding to the community
10-
Check out our [contribution guide](https://qsharp.community/contributing/), and please make a [pull request](https://help.github.com/en/articles/creating-a-pull-request) in this repo when you have something to add!
11+
## ๐Ÿ’™ Join the community ๐Ÿ’™
12+
Check out our [contribution guide](https://qsharp.community/contributing/), and hop on our [Discord](https://discord.qsharp.community) to chat with other folks learning and building with Q#.

โ€Ž_config.yml

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
# You can create any custom variable you would like, and they will be accessible
1515
# in the templates via {{ site.myvariable }}.
1616
title: Q# Community
17-
subtitle: Community-Driven Quantum Development
17+
#subtitle: Community-Driven Quantum Development
1818
email: info@qsharp.community
1919
description: >- # this means to ignore newlines until "baseurl:"
2020
A space for community-driven projects and contrib libraries for Q#
@@ -65,30 +65,33 @@ author:
6565
avatar : "/assets/images/qsharp-comm-logo.png"
6666
bio : "A space for community-driven projects and contrib libraries for Q#."
6767
links:
68-
- label: "Website"
69-
icon: "fas fa-fw fa-link"
70-
url: "https://qsharp.community/"
68+
- label: "Discord"
69+
icon: "fab fa-fw fa-discord"
70+
url: "https://discord.qsharp.community"
7171
- label: "Twitter"
7272
icon: "fab fa-fw fa-twitter-square"
7373
url: "https://twitter.com/QSharpCommunity"
7474
- label: "GitHub"
7575
icon: "fab fa-fw fa-github"
7676
url: "https://github.com/qsharp-community"
77-
- label: "Instagram"
78-
icon: "fab fa-fw fa-instagram"
79-
url: "https://www.instagram.com/qsharpcommunity"
77+
- label: "YouTube"
78+
icon: "fab fa-fw fa-youtube"
79+
url: "https://www.youtube.com/channel/UCjJmQ9n7AcfrekuyoRFBukQ"
8080

8181
footer:
8282
links:
83+
- label: "Discord"
84+
icon: "fab fa-fw fa-discord"
85+
url: "https://discord.qsharp.community"
8386
- label: "Twitter"
8487
icon: "fab fa-fw fa-twitter-square"
8588
url: "https://twitter.com/QSharpCommunity"
8689
- label: "GitHub"
8790
icon: "fab fa-fw fa-github"
8891
url: "https://github.com/qsharp-community"
89-
- label: "Instagram"
90-
icon: "fab fa-fw fa-instagram"
91-
url: "https://www.instagram.com/qsharpcommunity"
92+
- label: "YouTube"
93+
icon: "fab fa-fw fa-youtube"
94+
url: "https://www.youtube.com/channel/UCjJmQ9n7AcfrekuyoRFBukQ"
9295

9396
defaults:
9497
# _posts

โ€Ž_data/navigation.yml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
main:
2-
- title: "About"
3-
url: /about/
42
- title: "Projects"
53
url: /projects/
6-
- title: "Community Blog"
4+
- title: "Blog"
75
url: /posts/
8-
- title: "Resources"
6+
- title: "Learn"
97
url: /resources/
108
- title: "Contribute"
11-
url: /contributing/
9+
url: /contributing/
10+
- title: "About"
11+
url: /about/

โ€Ž_layouts/home.html

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,21 @@
11
---
2+
toc: true
23
layout: archive
34
author_profile: false
45
title: Welcome to the Q# Community!
56
permalink: /
6-
toc: false
77
---
8-
<h1>Welcome!</h1>
9-
<a href="https://gitter.im/qsharp-community/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge"><img src="https://badges.gitter.im/qsharp-community/community.svg" title="gitter-badge" /></a>
10-
<a href="https://join.slack.com/t/qsharp-community/shared_invite/zt-fnsl4u42-u21wdJRzlLF9oAqYTDDtwA"><img src="https://img.shields.io/badge/chat-on%20slack-blue" title="slack-badge" /></a>
11-
<img alt="GitHub" src="https://img.shields.io/github/license/qsharp-community/qsharp-community.github.io">
8+
<h1>๐Ÿ‘‹ Welcome!</h1>
9+
<a href="https://qsharp.community/coc"><img alt="Code of Conduct Badge" src="https://img.shields.io/badge/Q%23%20Community-Code%20of%20Conduct-%233b9cba?color=409ae1&" title="coc-badge" /></a>
10+
<a href="https://discord.qsharp.community"><img alt="Discord Badge" src="https://img.shields.io/discord/724763240751562794?color=409ae1&logo=Discord" title="discord-badge" /></a>
11+
<a href="https://twitter.com/qsharpcommunity"><img alt="Twitter Badge" src="https://img.shields.io/twitter/follow/qsharpcommunity?color=409ae1&logo=twitter&style=flat" title="discord-badge" /></a>
12+
<a href="https://github.com/qsharp-community/qsharp-community.github.io/blob/master/LICENSE"><img alt="GitHub Licence" src="https://img.shields.io/github/license/qsharp-community/qsharp-community.github.io"/></a>
1213
<br><br>
13-
This group collects + maintains projects related to the Q# programming language by a community of folks who are excited about quantum programming! ๐Ÿ˜Š
14+
The Q# Community collects + maintains projects related to the Q# programming language by a community of folks who are excited about quantum programming!
15+
16+
<h2 class="archive__subtitle">{{ site.data.ui-text[site.locale].recent_posts | default: "Featured Community Projects" }}</h2>
17+
18+
{% include feature_row %}
1419

1520
<h2 class="archive__subtitle">{{ site.data.ui-text[site.locale].recent_posts | default: "Recent Community Posts" }}</h2>
1621

@@ -20,7 +25,4 @@ <h2 class="archive__subtitle">{{ site.data.ui-text[site.locale].recent_posts | d
2025

2126
{% include paginator.html %}
2227

23-
<h2 class="archive__subtitle">{{ site.data.ui-text[site.locale].recent_posts | default: "Featured Community Projects" }}</h2>
24-
25-
{% include feature_row %}
2628

โ€Ž_pages/CONTRIBUTING.md

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,22 @@
22
permalink: /contributing/
33
title: Contributing to Q# Community
44
toc: true
5-
author_profile: false
5+
author_profile: true
66
---
77

88
This community encourages feedback and contributions.
99
Thank you for your interest in making the Q# Community better!
1010
There are several ways you can get involved.
1111

12-
## Adding a new repository to the community
12+
## Finding tasks you can help with
13+
14+
Looking for something to work on?
15+
Issues marked ``good first issue`` on all community repos are a good place to start.
16+
If you're interested in working on a fix, leave a comment to let everyone know and to help avoid duplicated effort from others.
17+
18+
You can also take a look at our [community roadmap](https://github.com/qsharp-community/roadmap) to see if there is any of our more general community goals you would be interested in helping with.
19+
20+
## Adding a new project to the community
1321

1422
Are you someone who has a project they want to contribute to the Q# community organization?
1523
There are a few main benefits to doing so:
@@ -32,28 +40,19 @@ The community generally suggests MIT licence, as most open source .NET projects
3240
## Reporting issues and suggesting new features
3341

3442
If something about one of the community projects is not working properly, please file an issue of the corresponding repository.
35-
If you have ideas for new features of the community throw them up on the [Gitter](https://gitter.im/qsharp-community/community) and maintainers can then create [projects](https://github.com/qsharp-community/qsharp-community.github.io/projects) on this repo to track progress and discussions.
43+
If you have ideas for new features of the community, please post in the #ask-the-admin channel on the [Discord](https://discord.qsharp.community) or [file an issue](https://github.com/qsharp-community/qsharp-community.github.io/issues/new/choose) on our main repo.
3644
Remember that all community interactions must abide by the [Code of Conduct](CODE_OF_CONDUCT.md).
3745

38-
## Finding issues you can help with
39-
40-
Looking for something to work on?
41-
Issues marked ``good first issue`` on all community repos are a good place to start.
42-
43-
You can also check the ``help wanted`` tags to find other issues to help with.
44-
If you're interested in working on a fix, leave a comment to let everyone know and to help avoid duplicated effort from others.
45-
4646
## Contributions we accept
4747

48-
We welcome your contributions to Q# community projects especially to fix bugs and to make improvements.
48+
We welcome your contributions to Q# community projects!๐ŸŽ‚
4949
Some general guidelines:
5050

5151
* **DO** follow the [Q# style guide](https://docs.microsoft.com/en-us/quantum/contributing/style-guide?view=qsharp-preview), and keep code changes as small as possible.
5252
* **DO** include corresponding tests whenever possible.
5353
* **DO** check for additional occurrences of the same problem in other parts of the codebase before submitting your PR.
5454
* **DO** [link the issue](https://github.com/blog/957-introducing-issue-mentions) you are addressing in the pull request.
5555
* **DO** write a good description for your pull request. More detail is better. Describe *why* the change is being made and *why* you have chosen a particular solution. Describe any manual testing you performed to validate your change.
56-
* **DO NOT** merge multiple changes into one PR unless they have the same root cause.
5756

5857
## Making changes to the code
5958

@@ -65,11 +64,11 @@ For projects that involve other languages, please use consistent styling.
6564
### Testing and Packaging
6665

6766
Your change should include tests to verify new functionality wherever possible.
68-
> Coming Soon: instructions on how to setup Azure DevOps pipelines for Q# projects
67+
> Coming Soon: instructions on how to setup GitHub Actions for Q# projects
6968
7069
## Review Process
7170

72-
After submitting a pull request, members of the Q# Community team will review your code.
71+
After submitting a pull request, members of the project will review your code.
7372
We will assign the request to an appropriate reviewer.
74-
Any member of the community may participate in the review, but at least one member of the Q# Community team will ultimately approve
75-
the request.
73+
Any member of the community may participate in the review, but at least one member of the project will ultimately approve
74+
the request.

โ€Ž_pages/about.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,18 @@ permalink: /about/
33
title: "About"
44
---
55

6-
This group collects + maintains projects related to the Q# programming language by a community of folks who are excited about quantum programming!
6+
The Q# Community collects + maintains projects related to the Q# programming language by a community of folks who are excited about quantum programming!
77
The types of content hosted here are (but are not limited to):
88

9-
- New community libraries for Q#
9+
- New libraries or tooling integrations for Q#
10+
- Implementations of particular algorithms in Q#
1011
- Tutorial or workshop materials featuring Q# code
1112
- Extensions to the Q# language itself that need some testing before being added to official repositories
1213
- Blog posts on cool Q# projects or documenting how you use the QKD
1314

1415
If you want to learn more about the process of adding a project to [qsharp-community](https://qsharp.community), please see our [community contribution guide](CONTRIBUTING.md).
1516

16-
We have a community [Gitter](https://gitter.im/qsharp-community/community?utm_source=share-link&utm_medium=link&utm_campaign=share-link) for quick questions and minimal login and a [Slack](https://join.slack.com/t/qsharp-community/shared_invite/zt-fnsl4u42-u21wdJRzlLF9oAqYTDDtwA) for more detailed discussions, so please use these channels to ask the community!
17-
They are both great if you have a question about Q# or the QDK, want us to cross-promote or host a blog post, or want to share a cool project you are working on!
17+
We have a community [Discord](https://discord.qsharp.community) for everything from quick questions to detailed project discussions, so please drop in and say Hi!
18+
This is a great place for your questions about Q# or the QDK, want us to cross-promote or host a blog post, or want to share a cool project you are working on!
1819

1920
> All activities in our community are governed by a [code of conduct](CODE_OF_CONDUCT.md), please email [info@quantum.community](mailto:info@quantum.community) if you have any questions or need to report something.

โ€Ž_pages/projects.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,27 @@ feature_row:
1616
url: "https://github.com/qsharp-community/qsharp-integrations"
1717
btn_label: "Learn More"
1818
btn_class: "btn--info"
19+
- image_path: /assets/images/qa-zoo.png
20+
alt: "Algorithm Zoo"
21+
title: "Algorithm Zoo"
22+
excerpt: "Reference implementations of quantum algorithms in Q#"
23+
url: "https://github.com/qsharp-community/algorithm-zoo"
24+
btn_label: "Learn More"
25+
btn_class: "btn--info"
1926
- image_path: /assets/images/chp-cover.png
2027
alt: "CHP Simulator"
2128
title: "CHP Simulator"
2229
excerpt: "Custom simulator backend for Q#"
2330
url: "https://github.com/qsharp-community/chp-sim"
2431
btn_label: "Learn More"
2532
btn_class: "btn--info"
33+
- image_path: /assets/images/discord-bot-cover.png
34+
alt: "Q# Discord Bot"
35+
title: "Q# Discord Bot"
36+
excerpt: "Run Q# snippets in Discord chat"
37+
url: "https://github.com/qsharp-community/qsharp-discord-bot"
38+
btn_label: "Learn More"
39+
btn_class: "btn--info"
2640
---
2741

2842

โ€Ž_pages/resources.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,24 @@
11
---
22
permalink: /resources/
3-
title: "Q# Community Resources"
3+
title: "Q# Learning Resources"
44
toc: true
55
---
66
Please make a [pull request](https://help.github.com/en/articles/creating-a-pull-request) on the repo for [this webpage](https://github.com/qsharp-community) if you have any suggestions for resources to add to this page!
77
{: .notice--info}
88

99
## Talks and Videos
10-
- [Programming quantum computers in .NET using Microsoft Q#](https://www.youtube.com/watch?v=qOg6weW-IDo), Rolf Huisman (Info Support)
11-
- [What is Quantum Machine Learning, and is it a Thing?](https://www.sckaiser.com/research/talks/ml4all_2019/), Sarah Kaiser (Pensar Development)
10+
- [Programming quantum computers in .NET using Microsoft Q#](https://www.youtube.com/watch?v=qOg6weW-IDo), Rolf Huisman
11+
- [What is Quantum Machine Learning, and is it a Thing?](https://www.sckaiser.com/research/talks/ml4all_2019/), Sarah Kaiser
1212
- [An Introduction to quantum programming through the Quantum Development Kit and Q#](https://www.youtube.com/watch?v=AjBLsrGgEkY), Bettina Heim (Microsoft)
1313
- [Quantum Computing for Computer Scientists](https://speakerdeck.com/ahelwer/quantum-computing-for-computer-scientists), Andrew Helwer (Microsoft)
14+
- Tons more videos on our [YouTube channel playlists](https://www.youtube.com/channel/UCjJmQ9n7AcfrekuyoRFBukQ/playlists)!
1415

1516
## Books
1617
- [_Learn Quantum Computing with Python and Q#_](http://www.manning.com/?a_aid=learn-qc-kaiser)
1718

1819
## Online Courses
1920
- [Quantum Computing](https://brilliant.org/courses/quantum-computing/) by Brilliant
21+
- [Microsoft Learn Paths](https://docs.microsoft.com/en-us/learn/paths/quantum-computing-fundamentals/)
2022

2123
## Awesome Lists
2224
- [Awesome Q#](https://project-awesome.org/ebraminio/awesome-qsharp)
@@ -36,10 +38,6 @@ Please make a [pull request](https://help.github.com/en/articles/creating-a-pull
3638
<th>Repo</th>
3739
<th>What can I find here?</th>
3840
</tr>
39-
<tr>
40-
<td><a href="https://github.com/microsoftdocs/quantum-docs-pr">Q# Docs</a></td>
41-
<td>Official Q# documentation at [docs.microsoft.com/quantum](https://docs.microsoft.com/quantum)</td>
42-
</tr>
4341
<tr>
4442
<td><a href="https://github.com/Microsoft/Quantum">Q# Samples</a></td>
4543
<td>Microsoft Quantum Development Kit Samples</td>
@@ -48,6 +46,10 @@ Please make a [pull request](https://help.github.com/en/articles/creating-a-pull
4846
<td><a href="https://github.com/Microsoft/QuantumLibraries">Q# Libraries</a></td>
4947
<td>Q# libraries for the Quantum Development Kit.</td>
5048
</tr>
49+
<tr>
50+
<td><a href="https://github.com/microsoft/qsharp-language">QuantumKatas</a></td>
51+
<td>Q# language and library design discussion/proposals</td>
52+
</tr>
5153
<tr>
5254
<td><a href="https://github.com/microsoft/qsharp-compiler">Q# Compiler</a></td>
5355
<td>Q# compiler for the Quantum Development Kit.</td>
@@ -56,6 +58,14 @@ Please make a [pull request](https://help.github.com/en/articles/creating-a-pull
5658
<td><a href="https://github.com/microsoft/qsharp-runtime">Q# Runtime</a></td>
5759
<td>Q# runtime components for the Quantum Development Kit.</td>
5860
</tr>
61+
<tr>
62+
<td><a href="https://github.com/microsoft/iqsharp">IQ# Kernel</a></td>
63+
<td>Kernel for the Jupyter platform, as well as the backend used by the Python client for Q#</td>
64+
</tr>
65+
<tr>
66+
<td><a href="https://github.com/microsoftdocs/quantum-docs-pr">Q# Docs</a></td>
67+
<td>Official Q# documentation at [docs.microsoft.com/quantum](https://docs.microsoft.com/quantum)</td>
68+
</tr>
5969
<tr>
6070
<td><a href="https://github.com/Microsoft/QuantumKatas">QuantumKatas</a></td>
6171
<td>Programming exercises for learning Q# and quantum computing</td>

โ€Ž_posts/2021-04-01-communityv2.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
title: "Q# Community v2.0 ๐ŸŽ‚"
3+
date: 2021-03-31T0:0:0-0:00
4+
categories:
5+
- blog
6+
tags:
7+
- update
8+
---
9+
10+
๐ŸŽ‰Hi from the Q# Community Admins!๐ŸŽ‰
11+
12+
It has been a really exciting few years for the quantum computing community as well as for Q# as a language. We have seen some really [amazing new features](https://docs.microsoft.com/en-us/azure/quantum/qdk-relnotes), an active and open [language design process](https://github.com/microsoft/qsharp-language), and the public (preview) launch of [Azure Quantum](https://azure.microsoft.com/en-us/services/quantum/).
13+
14+
It also happens to be the community's ๐ŸŽˆsecond birthday๐ŸŽˆ and it has been amazing to see what we have worked in together. We are also excited to share with you want is coming up and some new changes to our space!
15+
16+
- **We are moving to [Discord](https://discord.qsharp.community)**
17+
18+
There are a lot of ways and tools to build a space where folks feel they can ask questions and interact with each other in a fun and safe manner. Discord is one of the leaders in this space and we feel that it will better meet the needs of the community here than our current slack. If you haven't used before, check out some [info about the platform](https://discord.com/why-discord-is-different) from Discord.
19+
20+
- **Community office hours**
21+
22+
We will be hosting once a month on our discord community office hours where folks can ask questions, share what they are working on, or just general get to know others in the community. Especially with all the current remote work and conferences we are not getting the same opportunities to connect with other folks that we can learn from and work with. The first office hours will be [April 22 @ 10 AM PDT](https://www.starts-at.com/event/7995289407), make sure you join the discord and come say hi!
23+
24+
- **[Community road map](https://github.com/qsharp-community/roadmap) + volunteers**
25+
26+
We are excited to share a road map for what we want this community to look like for the next 3-5 years so firstly, [check it out here](https://github.com/qsharp-community/roadmap)! The issues on the repo correspond to the high-level goals for this year, so if you have any feedback about the goals, ideas on how we can achieve them, or want to volunteer to make them happen; please leave us a comment or chat on Discord ๐Ÿ’–
27+
28+
So what can you do to get involved and help build the Q# community with us?
29+
30+
> 1. Join our [Discord](https://discord.qsharp.community)
31+
> 2. Drop in at office hours on [April 22 @ 10 AM PDT](https://www.starts-at.com/event/7995289407)
32+
> 3. Take a look at the [roadmap](https://github.com/qsharp-community/roadmap) and check out our [contributing page](https://qsharp.community/contributing/) to see how you can get involved!
33+
34+
Stay safe and (Q) sharp! ๐Ÿ’™

0 commit comments

Comments
ย (0)