From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 0D5FA13933E for ; Sat, 10 Jul 2021 08:14:27 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 4DF87E0DC4; Sat, 10 Jul 2021 08:14:26 +0000 (UTC) Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id ED296E0DC4 for ; Sat, 10 Jul 2021 08:14:25 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 828F6340FFC for ; Sat, 10 Jul 2021 08:14:24 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 169567BA for ; Sat, 10 Jul 2021 08:14:23 +0000 (UTC) From: "Alessandro Barbieri" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Alessandro Barbieri" Message-ID: <1625904656.160299af5a0528aaf5dac60438f1d32822a6878e.Alessandro-Barbieri@gentoo> Subject: [gentoo-commits] repo/proj/guru:dev commit in: / X-VCS-Repository: repo/proj/guru X-VCS-Files: FAQ.md README.md X-VCS-Directories: / X-VCS-Committer: Alessandro-Barbieri X-VCS-Committer-Name: Alessandro Barbieri X-VCS-Revision: 160299af5a0528aaf5dac60438f1d32822a6878e X-VCS-Branch: dev Date: Sat, 10 Jul 2021 08:14:23 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: e94a7172-12c1-4057-9b07-b8f58f3e380b X-Archives-Hash: 353e86bfb47bc610b339bc3f97e9e487 commit: 160299af5a0528aaf5dac60438f1d32822a6878e Author: Alessandro Barbieri gmail com> AuthorDate: Sat Jul 10 08:10:56 2021 +0000 Commit: Alessandro Barbieri gmail 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 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 + +- #### 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 guru-committers@gentoo.org. + +- #### 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) -## Frequently Asked Questions - -- #### 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 guru-committers@gentoo.org. - -- #### 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 - #### Gentoo projects shouldn't be in the metadata files