Editing Getting involved

[[Category:About O3X]]
Getting involved and contributing benefits not only the community member and their fellow O3X users, but all users of [[Wikipedia:Free and open source software|free and open source software]].

This article describes how both new and experienced O3X users can contribute to the community. Note that this is not an exhaustive list.

== Official OpenZFS on OS X projects ==

=== Post on the forums ===

One of the easiest ways to get involved is participating in the [https://openzfsonosx.org/forum/ O3X Forums], which allow O3X users to get to know the community and help each other.

=== Improve this wiki ===

[[AboutWiki|O3XWiki]] is collaboratively maintained O3X documentation. All users are encouraged to [[O3XWiki:Contributing|contribute]].

=== Join the chatroom ===

You can help other users to solve problems in the [[IRC channel|IRC Channel]].

=== Fix and report bugs ===

Reporting and fixing bugs on the [https://github.com/openzfsonosx/openzfs/issues bug tracker] is one of the possible ways to help the community.

=== Code ===

Developers of all levels of experience and skill are encouraged to come talk about how they can contribute in the [[IRC channel|IRC Channel]] and on the [https://openzfsonosx.org/forum/viewforum.php?f=24 OpenZFS on OS X Development] forum.
@@ Line 21: / Line 21: @@
 Reporting and fixing bugs on the [https://github.com/openzfsonosx/openzfs/issues bug tracker] is one of the possible ways to help the community.
-When reporting errors, please ensure that you include sufficient contextual information to assist with reproduction, diagnosis and resolution of the issue. At a minimum consider describing what you were doing, how repeatable the issue is, all text from the stack dump, what OSX version, and what O3X version you are running.
-If you are experiencing panics, please turn keepsyms on (https://openzfsonosx.org/wiki/Install). This will make the stack dumps human readable, thereby improving our ability to diagnose.
-If you are deadlocking O3X, please run the spindump command after O3X deadlocks and before the machine becomes unusable and post the resulting output. There is often a narrow window of time to do this. Spindump needs to run with elevated permissions using sudo. Normally only administrators can do this.
-   #sudo spindump
-   Password:
-   Sampling all processes for 10 seconds with 10 milliseconds of run time between samples
-   Sampling completed, processing symbols...
-   Spindump analysis written to file /tmp/spindump.txt
-Copy the output file to an hfs filesystem and reboot.
-For real time assistance please see us on IRC, there is usually someone online that can help (https://openzfsonosx.org/wiki/IRC_channel)
 === Code ===
 Developers of all levels of experience and skill are encouraged to come talk about how they can contribute in the [[IRC channel|IRC Channel]] and on the [https://openzfsonosx.org/forum/viewforum.php?f=24 OpenZFS on OS X Development] forum.