commit: 160299af5a0528aaf5dac60438f1d32822a6878e Author: Alessandro Barbieri <lssndrbarbieri <AT> gmail <DOT> com> AuthorDate: Sat Jul 10 08:10:56 2021 +0000 Commit: Alessandro Barbieri <lssndrbarbieri <AT> gmail <DOT> com> CommitDate: Sat Jul 10 08:10:56 2021 +0000 URL: https://gitweb.gentoo.org/repo/proj/guru.git/commit/?id=160299af
move faq to FAQ.md Signed-off-by: Alessandro Barbieri <lssndrbarbieri <AT> gmail.com> FAQ.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ README.md | 56 ++++---------------------------------------------------- 2 files changed, 49 insertions(+), 52 deletions(-) diff --git a/FAQ.md b/FAQ.md new file mode 100644 index 000000000..f5d8b6629 --- /dev/null +++ b/FAQ.md @@ -0,0 +1,45 @@ +## Frequently Asked Questions <a name="FAQ"></a> + +- #### How do I emerge these ebuilds? + +`eselect repository enable guru && emerge --sync` and emerge the package just as usual. + +- #### How do I contribute? + +See [wiki.gentoo.org/wiki/Project:GURU/Information_for_Contributors](https://wiki.gentoo.org/wiki/Project:GURU/Information_for_Contributors) + +- #### What are the rules and regulations? + +See [wiki.gentoo.org/wiki/Project:GURU#The_regulations](https://wiki.gentoo.org/wiki/Project:GURU#The_regulations) + +- #### What does GURU stand for? + +This is very secret, but you might find a clue [here](https://dev.gentoo.org/~mgorny/articles/guru-a-new-model-of-contributing-to-gentoo.html#the-acronym). + +- #### [GLEP 63](https://www.gentoo.org/glep/glep-0063.html) says I should use a @gentoo.org email address for signing off, do I need an @gentoo.org email address to contribute to GURU? + +No, you do not need an @gentoo.org email address to contribute to GURU, these email addresses are for Gentoo developers only. Instead use whichever email address you want to receive bug mail and other communications on. If you're also a [proxy-maintainer](https://wiki.gentoo.org/wiki/Project:Proxy_Maintainers) please use the same email address. + +- #### Can I use RESTRICT="mirror"? + +Sure, since GURU packages are not mirrored on the [Gentoo mirrors](https://devmanual.gentoo.org/general-concepts/mirrors/index.html) anyway, it makes no difference. You can use RESTRICT="mirror" to avoid unnecessary fetch attempts. This is not required by GURU nor is it prohibited, just be sure to remove it if you want to move your package to the main Gentoo repository. + +- #### I need help, where do I go? + +You can reach other GURU contributors on [IRC #gentoo-guru](https://web.libera.chat/#gentoo-guru), or by emailing [email protected]. + +- #### I found a bug, what do I do? + +You can either contact the GURU contributors using one of the options in the previous point, or you can open a bug on our bug tracker: [bugs.gentoo.org/enter_bug.cgi?product=GURU](https://bugs.gentoo.org/enter_bug.cgi?product=GURU) + +- #### I found a bug in a package that I do not maintain, and I know how to fix it, can I fix it myself? + +As per [the regulations](https://wiki.gentoo.org/wiki/Project:GURU#The_regulations), yes, you can! Just be sure to maintain respectful and professional behaviour. + +- #### Can I commit a package without listing myself as explicit maintainer? + +As per [the regulations](https://wiki.gentoo.org/wiki/Project:GURU#The_regulations), yes, you can. + +- #### I want to make changes to this document, can I? + +Please discuss any changes and additions to this document on our [bug tracker](https://bugs.gentoo.org/enter_bug.cgi?product=GURU) prior to committing them. diff --git a/README.md b/README.md index a4f63dd25..5af9a694f 100644 --- a/README.md +++ b/README.md @@ -25,62 +25,14 @@ The [GURU regulations](https://wiki.gentoo.org/wiki/Project:GURU#The_regulations ### Contents -1. [Frequently Asked Questions](#FAQ) -2. [Common Mistakes](#CommMist) -3. [Other Tips and Tricks](#tips) -4. [Useful Links](#links) -5. [Email Addresses](#email) +1. [Common Mistakes](#CommMist) +2. [Other Tips and Tricks](#tips) +3. [Useful Links](#links) +4. [Email Addresses](#email) </td> </tr></table> -## Frequently Asked Questions <a name="FAQ"></a> - -- #### How do I emerge these ebuilds? - -`eselect repository enable guru && emerge --sync` and emerge the package just as usual. - -- #### How do I contribute? - -See [wiki.gentoo.org/wiki/Project:GURU/Information_for_Contributors](https://wiki.gentoo.org/wiki/Project:GURU/Information_for_Contributors) - -- #### What are the rules and regulations? - -See [wiki.gentoo.org/wiki/Project:GURU#The_regulations](https://wiki.gentoo.org/wiki/Project:GURU#The_regulations) - -- #### What does GURU stand for? - -This is very secret, but you might find a clue [here](https://dev.gentoo.org/~mgorny/articles/guru-a-new-model-of-contributing-to-gentoo.html#the-acronym). - -- #### [GLEP 63](https://www.gentoo.org/glep/glep-0063.html) says I should use a @gentoo.org email address for signing off, do I need an @gentoo.org email address to contribute to GURU? - -No, you do not need an @gentoo.org email address to contribute to GURU, these email addresses are for Gentoo developers only. Instead use whichever email address you want to receive bug mail and other communications on. If you're also a [proxy-maintainer](https://wiki.gentoo.org/wiki/Project:Proxy_Maintainers) please use the same email address. - -- #### Can I use RESTRICT="mirror"? - -Sure, since GURU packages are not mirrored on the [Gentoo mirrors](https://devmanual.gentoo.org/general-concepts/mirrors/index.html) anyway, it makes no difference. You can use RESTRICT="mirror" to avoid unnecessary fetch attempts. This is not required by GURU nor is it prohibited, just be sure to remove it if you want to move your package to the main Gentoo repository. - -- #### I need help, where do I go? - -You can reach other GURU contributors on [IRC #gentoo-guru](https://web.libera.chat/#gentoo-guru), or by emailing [email protected]. - -- #### I found a bug, what do I do? - -You can either contact the GURU contributors using one of the options in the previous point, or you can open a bug on our bug tracker: [bugs.gentoo.org/enter_bug.cgi?product=GURU](https://bugs.gentoo.org/enter_bug.cgi?product=GURU) - -- #### I found a bug in a package that I do not maintain, and I know how to fix it, can I fix it myself? - -As per [the regulations](https://wiki.gentoo.org/wiki/Project:GURU#The_regulations), yes, you can! Just be sure to maintain respectful and professional behaviour. - -- #### Can I commit a package without listing myself as explicit maintainer? - -As per [the regulations](https://wiki.gentoo.org/wiki/Project:GURU#The_regulations), yes, you can. - -- #### I want to make changes to this document, can I? - -Please discuss any changes and additions to this document on our [bug tracker](https://bugs.gentoo.org/enter_bug.cgi?product=GURU) prior to committing them. - - ## Common Mistakes <a name="CommMist"></a> - #### Gentoo projects shouldn't be in the metadata files
