diff --git a/web/html/beta.html b/web/html/beta.html new file mode 100644 index 00000000..2e0246d6 --- /dev/null +++ b/web/html/beta.html @@ -0,0 +1,168 @@ + + + + + AUR Beta + + +

Arch User Repository (AUR) Beta Test

+The Arch User Repository (AUR) is ready for beta testing. This release +does not contain every feature everyone wanted, but at this stage we +think we've implemented the most important features, and we need you to +help us make sure they are working properly and reliably. A few months +after the initial release, we'll start to prioritize +features necessary for the next revision. We'll weigh the suggestions +given and decide what additional features to add.
+
+

Audience

+For this test, we are not using the real Arch servers or +network bandwidth. As a result, you will find that +bandwidth will be somewhat limited. Please don't upload many large +packages, except where doing so helps to test a particular feature (or +misfeature) of the system.
+
+We expect this beta testing to be performed by TUs and a +handful of other users who are interested enough to subscribe to the TU +mailing list or otherwise seek out this information. Please do not advertise this beta site +information widely; we will not have the network +bandwidth to sustain a high load on the test platform and will need to +cut the beta short. +Once the beta is over, the real AUR will be hosted on the main Arch +Linux +servers and will be able to handle the greater demands of the whole +community.
+
+

Introduction to the AUR
+

+The AUR is a place for community members and TUs (Trusted Users) to +work together to bring new packages to Arch Linux users. A TU is a +special community member who has earned the trust of the core +Arch developers and who wants to help build, test, and debug new Arch +packages contributed by members of the community. Only a TU can build a +binary package and add it to the AUR +repository, which is then accessible via pacman -S.
+
+Any community member may upload new PKGBUILD directory tarballs +from the AUR +web interface. Those packages will appear in the "Unsupported" +repository, and +can be viewed and built by other community members, even though they +are not yet available in binary form via pacman -S.
+
+The AUR system +incorporates a voting system which allows members to vote for the +packages in "Unsupported" that they think are useful or interesting. If +a TU thinks a package is interesting or has received enough votes, +the TU may choose to adopt the package. The TU builds the package, +performs some rudimentary testing, and adds it +to the AUR repository, where it can be accessed by any user subscribing +to the AUR repository by running pacman -S. From that point on, the TU +will maintain the +package in the AUR repository, and all updates for the package must go +through a TU.
+
+If a package gets enough votes or is otherwise deemed interesting by +the core Arch development team, the package may be +promoted into the extra or current repository. At that point, the +package is removed from the AUR and is maintained by the core +developers. Alternately, if a TU loses interest in a package, the TU +may abandon the package or remove it from the AUR repository altogether.
+
+

Feedback

+The most important part of this beta test is your feedback. There is a project +set up in Flyspray for the AUR. Please leave your feedback there. +Though it will be tempting to email the AUR developers, remember that +they will get a lot of email and they won't be able to find yours later +when they're going through the feedback. If you put your bugs, +comments, and suggestions in Flyspray, they are guaranteed not to get +lost.
+
+Flyspray is incredibly easy to use. Take a moment to create an account +as soon as you can.
+
+

Schedule

+The AUR beta is starts now, around February 16. It should run until +about the end of February. At that point, it will look at the remaining +problems, fix them, and launch the AUR sometime in early March on the +production servers.
+

Using the AUR Repository

+To access the AUR repository from pacman, add the following to your +pacman.conf:
+
+[aur]
+Server = ftp://subzero.elys.com/arch/aur
+
+

What The AUR Means to a Community Member

+If you're an Arch Linux community member, the AUR represents a giant +step forward in your ability to effectively contribute your work in +building Arch packages to the rest of the Arch Linux community. The +following steps must ye take to get started:
+
    +
  1. Set yourself up to access the AUR repository, if desired, by +adding the above lines to your pacman.conf.
    +
    2. +
  2. Visit the AUR Beta Site.
    3. +
  3. Create a new user account.
    4. +
  4. Begin uploading packages you have created. You should upload a +.tar.gz file containing the PKGBUILD directory. You should not include +a binary package file in your upload, just the PKGBUILD and related +necessary files for building the package. (Imagine your package had +been accepted into current or extra; we want just the files that would +be fetched by abs in /var/abs.)
    +
    5. +
  5. Review the other packages in the repository, and vote for the +ones you find most interesting. If you're especially interested, browse +the package contents and build other packages yourself.
    6. +
+

What The AUR Means to a Trusted User (TU) or an Arch Developer
+

+If you are an Arch Linux Trusted User (TU) or an Arch developer, and +you want to get started on the beta, do the following:
+
    +
  1. Set your machine up to access the AUR repository.
    2. +
  2. Run pacman -S tupkg to download the TU package +download tool.
    +
    3. +
  3. Visit the AUR Beta Site.
    4. +
  4. Create a new user account, using your usual user id.
    +
    5. +
  5. Email Paul (paul at mattal dot com) and ask to have your login +modified to have TU/developer status.
    +This +step is necessary so we can make sure that the right people are getting +the right access. We will migrate this information to the production +system, so you won't have to do it again.
    +
    6. +
  6. Check out the CVS tree for the AUR repository, located at:
    + :pserver:<userid>@cvs.archlinux.org/home/cvs-aur-test
    +If you're +a TU or developer, you should already have an account in this new +repository.
    7. +
  7. Build binary packages for things you wish to place in the AUR, +and add the PKGBUILD and accompanying necessary files to the CVS +repository.
    +
    8. +
  8. Upload the binary packages using the "tupkg" tool. Run:
    +     tupkg +--host +subzero.elys.com --user <userid> --password <password> +<packagefile.pkg.tar.gz>
    +Note that this is your AUR login +password not your CVS password, in case they are different.
    +
    9. +
  9. Once your packages are uploaded successfully, tag the newly +created package files with the CURRENT tag in cvs.
    10. +
  10. In 5-10 minutes, the automated script will add them to the AUR +repository. Verify that they appear both in the web interface and +become +available via pacman -S from the aur repository.
    11. +
  11. Select the newly added or updated package in the AUR web +interface and set yourself as the maintainer.
    +
    12. +
+ +