Get In Touch: Difference between revisions

imported>Mic92
m Matrix: Updated member count
 
(126 intermediate revisions by 42 users not shown)
Line 1: Line 1:
This article describes how you can get involved in the NixOS ecosystem. Besides this wiki entry there is also the [https://nixos.org/nixos/community.html official Community Information Website of NixOS].
This article extends [https://nixos.org/community.html nixos.org/community] for how to get in touch and lists additional platforms to meet community members.


= Working on the nixpkgs repository =
See the [[Nix Community]] article to learn more about who we are.


Development in NixOS primarily driven by the work in [https://github.com/nixos/nixpkgs nixpkgs on github]. This repository contains both all packages available in your NixOS channel and all the options you can use for configuring your system with your <code>configuration.nix</code>. To get your text editor to recognize Nix expressions, consider installing a Nix [https://github.com/nixos-users/wiki/wiki/Editor-Modes editor mode].
== Official Spaces ==
These are spaces are moderated by the [https://nixos.org/community/teams/moderation/ NixOS Moderation Team]


== Report Issues ==
=== Events ===
See the [[Events]] page for past and upcoming events!


Any issue can be reported in the nixpkgs issue-tracker [https://github.com/nixos/nixpkgs/issues on github]. Keep in mind that all work on nixpkgs is being done by volunteers and you cannot expect a quick response and solution for all problems you may face. In general Pull-Requests have a much shorter round-trip-time.
See also the [https://conf.tube/accounts/nixcon/video-channels NixCon Fediverse] or [https://www.youtube.com/results?search_query=nixos YouTube] sites for past NixCon recordings.


== Create pull requests ==
=== Github ===


If you want to see your package being provided by a channel, creating an issue will most likely not enough. It is up to you to create a [[Contributing to nixpkgs|nix package description]] in nixpkgs and create a [[pull request]] in the nixpkgs repository.
* [https://github.com/NixOS/ NixOS] - Official Nix Org
** Contribute packages on [https://github.com/NixOS/nixpkgs nixpkgs]
** Develop the [https://github.com/NixOS/nix nix language]
** Participate in [https://github.com/NixOS/rfcs RFC discussions]
* [https://github.com/nix-community/ Nix-Community] - Explore community projects!


== Becoming a nixpkgs maintainer ==
=== Forums ===
* [https://discourse.nixos.org/ Official Discourse forum] - Ask for help here! (>14k users)


There are two types of maintainer: Members of the NixOS organization and package/module maintainer.
=== Chats ===


Members of the NixOS organization have direct access to the [https://github.com/Nixos/nixpkgs nixpkgs] and can therefor can merge [[Create-pull-requests|pull requests]].
==== Matrix ====


Everybody can become a package maintainer by adding to <code>maintainers</code> attribute in the meta section of a package. First add your nick handle (preferable your GitHub username) to [https://github.com/NixOS/nixpkgs/blob/master/lib/maintainers.nix#L3 lib/maintainer.nix] and reference the said handle within the package:
The official [https://matrix.to/#/#community:nixos.org NixOS Community Space] has rooms on many Nix topics.
* [https://matrix.to/#/#users:nixos.org #users:nixos.org] - Main Room (>4k members)
* [https://matrix.to/#/#wiki:nixos.org #wiki:nixos.org] - Wiki Contributors (>200 members)


<pre class="nix">{ stdenv, fetchurl }:
Note: If your client doesn't support [https://matrix.org/ecosystem/clients/ Matrix Spaces], see the [[MatrixRooms]] page for list of all rooms.
stdenv.mkDerivation rec {
  name = &quot;hello-2.10&quot;;
  # ....
  meta = with stdenv.lib; {
    # ...
    maintainers = with maintainers; [ eelco your-nick ]; # replace your-nick with your real nick
    platforms = platforms.all;
  };
}</pre>
There can be multiple maintainers per package. Maintainers will receive emails from [[Hydra|Hydra]] when package builds enters a failed state. They do not have special privileges as everybody can suggest updates and modifications to any package. However they might be consulted by NixOS members for testing and as a domain experts, when somebody else make a change to a package.


= Communication =
==== Zulip ====


== Join the mailinglist ==
* [https://nixpkgs.zulipchat.com/#recent NixOS Governance Discussion]  - Ongoing NixOS Governance discussions occurring here. Requires contribution to nixpkgs to participate.


There is currently only one official Mailinglist related to NixOS, [https://groups.google.com/forum/#!forum/nix-devel nix-devel]. You don't need to be a developer to use nix-devel.
==== Jitsi ====
* [https://meet.jit.si/NixOfficeHours OfficeHours] - Weekly Nix Office Hours (1600-2000 UTC Fridays, more times as mentors are available)


== Join the chat ==
== Officially Maintained ==
''Unmoderated'' spaces maintained by the moderation team.


The official NixOS channel resides on [https://webchat.freenode.net/ irc.freenode.org] in <code>#nixos</code> ([https://botbot.me/freenode/nixos/ searchable Log]).
==== [https://chaos.social/@nixos_org Mastodon] ====


In addition to that there is also the unofficial [[https://riot.im/app/#/room/#nix:matrix.org|NixOS matrix channel]]
==== [https://twitter.com/nixos_org Twitter] ====


== Join the forums ==
==== [https://www.linkedin.com/company/nixos-foundation/ LinkedIn] ====


Check out the [https://www.reddit.com/r/NixOS/ NixOS Reddit channel] and help answering questions on Stack Overflow for [https://stackoverflow.com/questions/tagged/nixos NixOS] and [https://stackoverflow.com/questions/tagged/nix nix].
== Unofficial Spaces ==
Spaces maintained by members of the community.
 
=== Forums ===
 
* [https://www.reddit.com/r/NixOS/ r/NixOS] on Reddit (>35k members)
 
* [https://programming.dev/c/nix !nix@programming.dev] on Lemmy (>1k subscribers)
 
* [https://stackoverflow.com/questions/tagged/nixos+or+nix+or+nixops+or+nixpkgs Stack Overflow] (>1k questions answered)
* [https://unix.stackexchange.com/questions/tagged/nixos+or+nix+or+nixops+or+nixpkgs Unix & Linux Stack Exchange] (>400 questions answered)
 
=== Chats ===
 
==== Discord ====
 
* [https://discord.gg/Vs4SWzFnWz Nix/NixOS (Unoffical)] (>12k members)
* [https://discord.gg/zaz3H6UsYk Nix/NixOS Community] (>200 members)<ref>https://discourse.nixos.org/t/new-discord-to-discuss-nix-nixos-and-the-wider-ecosystem/51953</ref>
 
==== IRC ====
Previously hosted on Freenode but was switched to libera.chat. There are [https://logs.nix.samueldr.com/ public logs] from the Freenode versions of these channels.
 
* [ircs://irc.libera.chat:6697/nixos #nixos] - General NixOS and Nix help
* [ircs://irc.libera.chat:6697/nixos/nix-darwin #nix-darwin] - Nix on macOS
* [ircs://irc.libera.chat:6697/nixos-chat #nixos-chat] - Informal chit-chat channel when going off-topic in the main channel
* [ircs://irc.libera.chat:6697/nixos-dev #nixos-dev] - Nix and NixOS development (#nixos for questions)
* [ircs://irc.libera.chat:6697/nixos-emacs #nixos-emacs] - Nix Emacs discussion
 
===== Regional IRC =====
 
* [ircs://irc.libera.chat:6697/nixos-cs #nixos-cs] - Czech and Slovak NixOS community
* [ircs://irc.libera.chat:6697/nixos-fr #nixos-fr] - French NixOS community
* [irc://irc.hackint.org/nixos #nixos] - German NixOS community on [https://hackint.org hackint.org] ([https://webirc.hackint.org webchat])
 
==== Regional Telegram ====
There are some regional Telegram groups dedicated to NixOS:
 
* [https://t.me/NixOS_zhcn @NixOS_zhcn] - Chinese, English
* [https://t.me/ru_nixos @ru_nixos] - Russian, English
* [https://t.me/nixos_en @nixos_en] - English
* [https://t.me/nixosbr @nixosbr] - Portuguese
* [https://t.me/nixosita @nixosita] - Italian
 
==== Signal ====
 
* [https://signal.group/#CjQKIOJMxvGvEgIsYgjVrhCDDvNaMWg5u6QvbxTZVvFLXxP9EhCZ62ghyNi1mUZJIinAlpqi Nix / NixOS] - General nix and NixOS signal group
 
== References ==
[[Category:Community]]