Note

The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.

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...")
 
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
= How do I Contribute to Funtoo Linux? =
__NOTITLE__
==== 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 ====


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.
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 our community that you would like to see improved. This may give you some guidance on where to become involved. My recommendation is to follow your passions and do what you enjoy.


==== Areas of Contribution ====
==== Areas of Contribution ====
Line 21: Line 18:
* '''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 [http://forums.funtoo.org 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.
* '''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 [http://forums.funtoo.org 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.
* '''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 the workflow of bugs on [https://bugs.funtoo.org our bug tracker], by either submitting issues, or participating in the process of discussing or fixing bugs, or both. 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>
==== Linux and Learning ====
* 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? ===
You don't need to choose just one area to get involved -- simply be aware of all the different ways that you ''can'' be involved. You're encouraged to explore all the various areas of involvement that are of interest to you.  


We have various package.mask files in <tt>funtoo-overlay</tt>:
I also encourage you to choose areas of involvement that fuel your own self-directed learning related to technology. As you probably know by now, Funtoo Linux is an incredible way to learn about many different facets of software design, engineering and use. It's my hope that you will find a niche in our community that supports you as you learn, and is fun, too :)


* <tt>funtoo-cautionary</tt> - masks that are in place to protect us from upstream changes in Gentoo Linux, or from ourselves.
[[Category:Official Documentation]]
* <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>

Latest revision as of 02:17, July 25, 2019

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 our community that you would like to see improved. This may give you some guidance on where to become involved. My recommendation is to follow your passions and do what you enjoy.

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 the workflow of bugs on our bug tracker, by either submitting issues, or participating in the process of discussing or fixing bugs, or both. 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.

Linux and Learning

You don't need to choose just one area to get involved -- simply be aware of all the different ways that you can be involved. You're encouraged to explore all the various areas of involvement that are of interest to you.

I also encourage you to choose areas of involvement that fuel your own self-directed learning related to technology. As you probably know by now, Funtoo Linux is an incredible way to learn about many different facets of software design, engineering and use. It's my hope that you will find a niche in our community that supports you as you learn, and is fun, too :)