Commit 2c60e198 authored by Robert Ricci's avatar Robert Ricci

Start on the user documentation

parent ee8ced8c
#lang scribble/manual
@(require "defs.rkt")
@title{Apt Users}
@title[#:tag "users"]{Apt Users}
You may either use Apt as a @seclink["guest-users"]{guest} or as a
@seclink["registered-users"]{registered user}.
Using Apt as a guest is a great way to give it a try; if you find it useful
and want to start using it for ``real work,'' you should
@seclink["register"]{sign up for a (free) account}, because a guest account (1)
won't let you hold your experiments for very long and (2) only allows you to
use virutal machines, which are not ideal for reproducing results, since they
don't have strong performance isolation from other users.
@section[#:tag "guest-users"]{Guest Users}
You may become a guest user simply by entering your email address on Apt's
@hyperlink[(apturl "instantiate.php")]{``Instantiate an Experiment''} page and
picking a username. Apt will send you an email with a verification code - be
sure to check your spam folder if you don't receive it within a few minutes.
You'll remain logged in to Apt as long as you use the same browser and it
retains its cookies. If you get logged out for any reason, simply enter the
same email address and username again, and you'll be sent a new verification
code.
Guest users are limited in several ways:
@itemlist[
@item{Guests are only allowed to hold experiments for a short period of
time---a few hours to start with, and they can extend this up to a day}
@item{Access to some resources (such as bare metal and large VMs) is not
allowed, meaning that some profiles which require these things are not
available}
@item{Experiments held by guest user are very heavily firewalled---no outgoing
connections are allowed, and almost all incoming traffic is blocked}
@item{Guest users are only allowed to have one active experiment at a time}
@item{Guest users may not create profiles}
]
If you are going to use Apt for much serious work, we encourage you to
@secref{register}.
@section[#:tag "registered-users"]{Registered Users}
Registering for an account is quick and easy. Registering doesn't cost
anything, it's simply for accountability. We just ask that if you're going to
use Apt for anything other than light use, you tell us a bit more about who you
are and what you want to use Apt for.
@subsection[#:tag "register"]{Register for an Account}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment