Difference between revisions of "Contributing"

From Funtoo
Jump to navigation Jump to search
(Created page with "= How do I Contribute to Funtoo Linux? = __NOTITLE__ ==== Welcome! ==== First, thanks for your interest in becoming an active part of the Funtoo Linux community! I welcome c...")
 
Line 4: Line 4:
==== Welcome! ====
==== Welcome! ====


First, thanks for your interest in becoming an active part of the Funtoo Linux community! I welcome contributions to the project, and there are a number of ways to have fun and get involved. This page is designed to help you find a place where you can be productive and help the Funtoo Linux technology and community grow and improve.
''First, thanks for your interest in becoming an active part of the Funtoo Linux community! I welcome contributions to the project, and there are a number of ways to have fun and get involved. This page is designed to help you find a place where you can be productive and help the Funtoo Linux technology and community grow and improve.


Best Regards,
Best Regards,


Daniel Robbins,
Daniel Robbins,
BDFL
BDFL''


==== Start as a User ====
==== Start as a User ====
Line 22: Line 22:
* '''Wiki Contributor''' -- Wiki contributors add new content to our wiki -- the site you are on now -- and help to improve existing content. Some translate key Funtoo Linux documentation into other languages.
* '''Wiki Contributor''' -- Wiki contributors add new content to our wiki -- the site you are on now -- and help to improve existing content. Some translate key Funtoo Linux documentation into other languages.
* '''Code Contributor''' -- Code contributors help to make the Funtoo Linux software better. You may be surprised to know that this can be done in many different ways. Some people may contribute or maintain new ebuilds that get integrated into Funtoo Linux. Others may be involved in [https://bugs.funtoo.org our bug tracker], by submitting issues, or participating in the process of fixing bugs. This is something that does not necessarily require 'hard-core' development skills but can make a significant difference. And some may assist me in maintaining the core Funtoo Linux system, or adding new functionality to Funtoo Linux itself.
* '''Code Contributor''' -- Code contributors help to make the Funtoo Linux software better. You may be surprised to know that this can be done in many different ways. Some people may contribute or maintain new ebuilds that get integrated into Funtoo Linux. Others may be involved in [https://bugs.funtoo.org our bug tracker], by submitting issues, or participating in the process of fixing bugs. This is something that does not necessarily require 'hard-core' development skills but can make a significant difference. And some may assist me in maintaining the core Funtoo Linux system, or adding new functionality to Funtoo Linux itself.
<noinclude>
* First, you need to actually ''use'' Funtoo Linux in some capacity.
* {{CreateAccount}}
* Help in the [http://forums.funtoo.org forums].
* Find things that need fixing on [https://bugs.funtoo.org the bug tracker], and submit fixes for them.
* If you have a new ebuild, then create an issue on [https://bugs.funtoo.org the bug tracker] for it.
* Testing things and finding bugs is also a form of help.
* Help us document stuff on the wiki. See [[Help:Funtoo Editing Guidelines|How to 'wiki']].
* Hang out in <tt>#funtoo</tt> on freenode and chat with us.
* Learn more about ebuilds by reading our [[Developer Guide]]. Ask questions.
* [[Compare Forked Packages To Gentoo]], find one that needs updating, and ask us how to help.
* Subscribe to [[Funtoo_RSS_and_Atom_Feeds | funtoo's rss feeds]].
== Common Questions ==
=== How should a developer use package.mask? ===
We have various package.mask files in <tt>funtoo-overlay</tt>:
* <tt>funtoo-cautionary</tt> - masks that are in place to protect us from upstream changes in Gentoo Linux, or from ourselves.
* <tt>funtoo-staging</tt> - stuff that is masked for testing, and is intended to be unmasked soon.
* <tt>funtoo-toolchain</tt> - masks related to our toolchain, which is treated with care (we like to upgrade it in a careful and coordinated fashion.)
* <tt>funtoo-udev</tt> - this may disappear soon -- it's one of those mask files that we create for a special purpose -- in this case, stuff related to our <tt>eudev</tt> migration.
</noinclude>

Revision as of 21:18, August 30, 2015

How do I Contribute to Funtoo Linux?

Welcome!

First, thanks for your interest in becoming an active part of the Funtoo Linux community! I welcome contributions to the project, and there are a number of ways to have fun and get involved. This page is designed to help you find a place where you can be productive and help the Funtoo Linux technology and community grow and improve.

Best Regards,

Daniel Robbins, BDFL

Start as a User

First things first -- be sure to Install Funtoo Linux and focus on being a user of Funtoo Linux first. The Funtoo Linux community model is user-centric -- it focuses around the needs of the people who use our software. When you use Funtoo Linux, you may notice areas of the software or community that you would like to see improved. This may give you some guidance on where to become involved.

Areas of Contribution

The ways you can become part of the Funtoo community can be broken down into a few broad categories:

  • Community Interaction and Involvement -- this simply means to participate in our community as a user, and interact with other users on IRC and/or our forums. Being present and involved in our online communities allows you to help others who need help, and also allows you to be social and interact with other people who have similar interests.
  • Wiki Contributor -- Wiki contributors add new content to our wiki -- the site you are on now -- and help to improve existing content. Some translate key Funtoo Linux documentation into other languages.
  • Code Contributor -- Code contributors help to make the Funtoo Linux software better. You may be surprised to know that this can be done in many different ways. Some people may contribute or maintain new ebuilds that get integrated into Funtoo Linux. Others may be involved in our bug tracker, by submitting issues, or participating in the process of fixing bugs. This is something that does not necessarily require 'hard-core' development skills but can make a significant difference. And some may assist me in maintaining the core Funtoo Linux system, or adding new functionality to Funtoo Linux itself.