Difference between revisions of "Newcomers"

From OpenZFS
Jump to navigation Jump to search
Line 2: Line 2:
== Welcome ==
== Welcome ==


OpenZFS brings together developers and users from various open-source forks of the original ZFS on different platforms and we're always looking to grow our community. There are a multitude of ways to contribute to the project and contributors happy to help newcomers. As we add diverse perspectives, our community becomes richer, and we're committed to creating an environment where all people feel welcome.   
OpenZFS brings together developers and users from various open-source forks of the original ZFS on different platforms and we're always looking to grow our community.
There are a multitude of ways to contribute to the project and contributors happy to help newcomers. As we add diverse perspectives, our community becomes richer, and
we're committed to creating an environment where all people feel welcome.   




== Resources for Newcomers ==
== Newcomer Resources ==


=== Discussion ===
=== Where can I learn more about OpenZFS? ===


The community communicates a couple different ways - some of the main ones include:
Here are some introductory resources. For more details about specific parts of ZFS look at the [[Developer_resources |  developer resources page]]
{| class="wikitable"
|-
|[https://www.youtube.com/watch?v=MsY-BafQgj4 OpenZFS Basics] || Matt Ahrens and George Wilson || May 2018
|-
|[https://www.youtube.com/watch?v=ptY6-K78McY Lecture on ZFS Read/Write Code Paths ] || Matt Ahrens || March 2016
|-
|[https://www.youtube.com/watch?v=uJGkyMxdNFE&t=1282s OpenZFS Novel Algorithms] || Matt Ahrens || March 2017
|-
|}


* An OpenZFS [[Mailing_list | mailing list]] designed for ZFS developers to review ZFS code and architecture changes from all platforms.
=== I have a question! ===
* A [https://openzfs.slack.com Slack workspace] that you're welcome to join for questions, communication during conferences, and general community discussion.
* The [https://twitter.com/OpenZFS OpenZFS Twitter account], which shares community updates and promotes ZFS-related events, blog posts, and talks.


- contact people responsible - serapheim
We are looking forward to hear it! The best way to reach us with questions is by joining our Slack channel #openzfs in [https://openzfs.slack.com OpenZFS@Slack].


=== Getting Started ===
=== I'd like to stay informed about events and new features! ===
- Section: What's easiest way to get started -> Documentation+Wiki, ZoL Get Started + userspace changes, kernel bugs - serapheim


=== Learning about ZFS ===
Then you should follow us on Twitter [https://twitter.com/OpenZFS @OpenZFS] . This is our main channel for sharing community updates and promotions of ZFS-related events, blogposts, and talks.


Here are some introductory resources. For more details about specific parts of ZFS look at the [[Developer_resources |  developer resources page]]  
The main OpenZFS-specific events that have been taking place consistently for the past few years are:
* The [[OpenZFS_Developer_Summit_2018 | OpenZFS Developer Summit]]
* The [https://zfs.datto.com/ ZFS User Conference]
 
That said, OpenZFS related talks have been popping up in other conferences. For a full list of present, future, and past events and talks see [[Events]] .
 
=== I'd like to contribute! ===
 
That's great! We are always looking to grow our community!
 
If you would like to submit a bug or just search for a bug to tackle, below is the list of the code repositories and bug lists for each platform supporting OpenZFS:
{| class="wikitable"
{| class="wikitable"
| '''illumos'''
|[http://wiki.illumos.org/display/illumos/ZFS Webpage]
|[https://github.com/illumos/illumos-gate/ Source]
|[https://www.illumos.org/issues Issues]
|-
|-
|[https://www.youtube.com/watch?v=MsY-BafQgj4 OpenZFS Basics] || Matt Ahrens and George Wilson || May 2018
| '''FreeBSD'''
|-
|[https://wiki.freebsd.org/ZFS Webpage]
|[https://www.youtube.com/watch?v=ptY6-K78McY Lecture on ZFS Read/Write Code Paths ] || Matt Ahrens || March 2016
|[https://github.com/freebsd/freebsd/ Source]
|[https://bugs.freebsd.org/bugzilla/ Issues]
|-
|-
|[https://www.youtube.com/watch?v=uJGkyMxdNFE&t=1282s OpenZFS Novel Algorithms] || Matt Ahrens || March 2017
| '''ZFS on Linux (ZoL)'''
|[http://zfsonlinux.org/ Webpage]
|[https://github.com/zfsonlinux/zfs/ Source]
|[https://github.com/zfsonlinux/zfs/issues Issues]
|-
|-
| '''ZFS-OSX'''
|[https://openzfsonosx.org/ Source]
|[https://github.com/openzfsonosx/zfs GitHub]
|[https://github.com/openzfsonosx/zfs/issues Issues]
|}
|}
- experts link - serapheim


=== Events ===
If you are just looking for a place to start and get your hands dirty, getting ZoL set up quickly on your computer or in a VM is straightforward (see [https://github.com/zfsonlinux/zfs/wiki/Building-ZFS Building ZoL]).
* [[OpenZFS_Developer_Summit_2018 | OpenZFS Developer Summit]] - [https://www.youtube.com/playlist?list=PLaUVvul17xSfgoTmcgjC0MQPGC2fmljL6 Videos from 2017]
Then you can try tackling one of the bugs in the [https://github.com/zfsonlinux/zfs/labels/bitesize bitesize] labeled buglist.
* [https://zfs.datto.com/ ZFS User Conference] - [https://vimeo.com/album/5150026 Videos from 2018]  
 
* Checkout the [[Events]] page for others
Remember that submitting code in ZFS is not the only way to contribute to the project. Other ways include but are not limited to the following:
* Write high-level utilities and libraries that leverage the power of OpenZFS.
* Write a blogpost or a tutorial for a new feature. We'll do our best to promote it.
* General Wiki and Documentation updates.
* Community Outreach- XXX
 
If you are still not sure where to start or you have more questions, you can see what's going on in our #newcomers Slack channel or ping @sara and @serapheim directly.

Revision as of 23:38, 21 August 2018

Welcome

OpenZFS brings together developers and users from various open-source forks of the original ZFS on different platforms and we're always looking to grow our community. There are a multitude of ways to contribute to the project and contributors happy to help newcomers. As we add diverse perspectives, our community becomes richer, and we're committed to creating an environment where all people feel welcome.


Newcomer Resources

Where can I learn more about OpenZFS?

Here are some introductory resources. For more details about specific parts of ZFS look at the developer resources page

OpenZFS Basics Matt Ahrens and George Wilson May 2018
Lecture on ZFS Read/Write Code Paths Matt Ahrens March 2016
OpenZFS Novel Algorithms Matt Ahrens March 2017

I have a question!

We are looking forward to hear it! The best way to reach us with questions is by joining our Slack channel #openzfs in OpenZFS@Slack.

I'd like to stay informed about events and new features!

Then you should follow us on Twitter @OpenZFS . This is our main channel for sharing community updates and promotions of ZFS-related events, blogposts, and talks.

The main OpenZFS-specific events that have been taking place consistently for the past few years are:

That said, OpenZFS related talks have been popping up in other conferences. For a full list of present, future, and past events and talks see Events .

I'd like to contribute!

That's great! We are always looking to grow our community!

If you would like to submit a bug or just search for a bug to tackle, below is the list of the code repositories and bug lists for each platform supporting OpenZFS:

illumos Webpage Source Issues
FreeBSD Webpage Source Issues
ZFS on Linux (ZoL) Webpage Source Issues
ZFS-OSX Source GitHub Issues

If you are just looking for a place to start and get your hands dirty, getting ZoL set up quickly on your computer or in a VM is straightforward (see Building ZoL). Then you can try tackling one of the bugs in the bitesize labeled buglist.

Remember that submitting code in ZFS is not the only way to contribute to the project. Other ways include but are not limited to the following:

  • Write high-level utilities and libraries that leverage the power of OpenZFS.
  • Write a blogpost or a tutorial for a new feature. We'll do our best to promote it.
  • General Wiki and Documentation updates.
  • Community Outreach- XXX

If you are still not sure where to start or you have more questions, you can see what's going on in our #newcomers Slack channel or ping @sara and @serapheim directly.