Commit 66d9475c authored by Robert Ricci's avatar Robert Ricci

Another editing pass

parent 2a90b7e1
......@@ -10,8 +10,9 @@ 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.
use @seclink["virtual-machines"]{virutal machines}, which are not ideal for
@seclink["repeatable-research"]{reproducing results}, since they don't have
strong performance isolation from other users.
@section[#:tag "guest-users"]{Guest Users}
......@@ -44,17 +45,17 @@ If you are going to use Apt for much serious work, we encourage you to
@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.
Registering for an account is @seclink["register"]{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.
Users in Apt are grouped into @italic{projects}: a project is a
(loosely-defined) group of people working together on some common goal, whether
that be a research project, a class, etc. Apt places a lot of trust on project
leaders, including the ability to authorize others to use the Apt. We therefore
require that project leaders be faculty, senior research staff, or others who
are relatively senior positions.
Users in Apt are grouped into @seclink["projects"]{@italic{projects}}: a
project is a (loosely-defined) group of people working together on some common
goal, whether that be a research project, a class, etc. Apt places a lot of
trust on project leaders, including the ability to authorize others to use the
Apt. We therefore require that project leaders be faculty, senior research
staff, or others who are relatively senior positions.
@section[#:tag "register"]{Register for an Account}
......@@ -70,7 +71,7 @@ password.
@subsection[#:tag "join-project"]{Join an existing project}
@TODO{Screen shot here}
@screenshot["join-project.png"]
To join an existing project, simply use the ``Sign Up'' button found on every
Apt page. The form will ask you a few basic questions about yourself and the
......@@ -83,15 +84,15 @@ at the first few steps in
guide to generating SSH keys}. (Obviously, the steps about how to upload the
keypair into GitHub don't apply to Apt.)
@margin-note{Apt will send you email to confirm your address---watch for it (it
might end up in your spam folder), as your request won't be processed until
you've confirmed your address.}
You'll be asked to enter the project ID for the project you are asking to
join; you should get this from the leader of the project, likely your advisor
or your class instructor. (If they don't already have a project on Apt, you
can @seclink["create-project"]{ask them to create one}.) The leader of your
project is responsible for approving your account.
@margin-note{Apt will send you email to confirm your address---watch for it (it
might end up in your spam folder), as your request won't be processed until
you've confirmed your address.}
@subsection[#:tag "create-project"]{Create a new project}
......@@ -121,6 +122,10 @@ Note that projects in Apt are publicly-listed: a page that allows users to
see a list of all projects and search through them does not exist yet, but
it will in the future.
@;{
@subsection[#:tag "invite-project"]{Invite others to join your project}
@TODO{Write about this when the feature is finished}
}
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