Merge branch 'partition-access' into 'master'

Add docs for accessing priority access partitions.

See merge request !245

content/submitting_jobs/partitions/_index.md

@@ -53,7 +53,7 @@ nodes, described in the resources capabilities section of the
 [HCC Documentation]({{< relref "/#resource-capabilities" >}})
 and the partition sections above.
 
-### Owned Partitions
+### Owned/Priority Access Partitions
 
 Partitions marked as owned by a group means only specific groups are
 allowed to submit jobs to that partition.  Groups are manually added to
@@ -61,6 +61,35 @@ the list allowed to submit jobs to the partition.  If you are unable to
 submit jobs to a partition, and you feel that you should be, please
 contact {{< icon name="envelope" >}}[hcc-support@unl.edu](mailto:hcc-support@unl.edu).
 
+To submit jobs to an owned partition, use the SLURM `--partition` option. Jobs
+can either be submitted *only* to an owned partition, or to *both* the owned
+partition and the general access queue. For example, assuming a partition
+named `mypartition`:
+
+{{% panel theme="info" header="Submit only to an owned partition" %}}
+{{< highlight bash >}}
+#SBATCH --partition=mypartition
+{{< /highlight >}}
+{{% /panel %}}
+
+Submitting solely to an owned partition means jobs will start immediately until
+the resources on the partition are full, then queue until prior jobs finish and
+resources become available.
+
+
+{{% panel theme="info" header="Submit to both an owned partition and general queue" %}}
+{{< highlight bash >}}
+#SBATCH --partition=mypartition,batch
+{{< /highlight >}}
+{{% /panel %}}
+
+Submitting to both an owned partition and `batch` means jobs will run on both the owned
+partition and the general batch queue. Jobs will start immediately until the resources
+on the partition are full, then queue. Pending jobs will then start either on the owned partition
+or in the general queue, wherever resources become available first
+(taking into account FairShare). Unless there are specific reasons to limit jobs
+to owned resources, this method is recommended to maximize job throughput.
+
 ### Guest Partition
 
 The `guest` partition can be used by users and groups that do not own