rewrote some help texts to make them more explanatory thus more useful

django/allgo/main/forms.py

@@ -107,13 +107,13 @@ class JobForm(forms.ModelForm):
             required=False,
             label='Files to upload',
             label_suffix='',
-            help_text='Select all the files you want to upload by clicking on "Choose file"')
+            help_text='Click "Choose file" to select and upload your job\'s  input files')
     queue_id = forms.ModelChoiceField(
             queryset=JobQueue.objects.all().distinct(),
             initial=1,
             label='Queue',
             label_suffix='',
-            help_text=mark_safe('You can refer to the <a href="https://allgo.gitlabpages.inria.fr/doc/deploy.html#queue-type">queue type documentation</a> for further explanation.'),
+            help_text=mark_safe('The <a href="https://allgo.gitlabpages.inria.fr/doc/run.html?highlight=queue#queue">queue for scheduling your job</a>. Queues with shorter limit have a higher priority.'),
             )
     param = forms.CharField(label='Parameters', label_suffix='', required=False, help_text='Enter the parameters you need or click on the "presets" button to select any predefined one.')
     webapp_parameters = forms.ModelChoiceField(
@@ -168,7 +168,7 @@ class WebappForm(forms.ModelForm):
 
     # Basic
     name = forms.CharField(label="Application name", label_suffix="")
-    contact = forms.EmailField(label="Email contact", label_suffix="", required=False, help_text="Enter a valid email only if someone else will be the user's contact.")
+    contact = forms.EmailField(label="Email contact", label_suffix="", required=False, help_text="By default this will be your personnal e-mail address. You may fill this field if you wish to use a different contact address.")
     description = forms.CharField(widget=forms.Textarea, label="Description", label_suffix="")
     private = forms.TypedChoiceField(
             coerce=lambda x: x == 'True',
@@ -176,7 +176,7 @@ class WebappForm(forms.ModelForm):
             initial=True,
             label="Private mode",
             label_suffix='',
-            help_text='Select the "private" option if you want to restrict the visibility to yourself.',
+            help_text='Private apps do not appears in the public list, but they are reachable by users knowing the url.',
             widget=forms.RadioSelect)
 
     # Advanced
@@ -190,10 +190,10 @@ class WebappForm(forms.ModelForm):
     job_queue = forms.ModelChoiceField(
             queryset=JobQueue.objects.all().distinct().order_by("timeout"),
             label='Default job queue',
-            help_text=mark_safe('You can refer to the <a href="https://allgo.gitlabpages.inria.fr/doc/deploy.html#queue-type">queue type documentation</a> for further explanation.'),
+            help_text=mark_safe('The default <a href="https://allgo.gitlabpages.inria.fr/doc/deploy.html#queue">queue for scheduling new jobs</a> using this app.'),
             label_suffix='')
     entrypoint = forms.CharField(label="Entrypoint", label_suffix="",
-            help_text=mark_safe('You can refer to the <a href="https://allgo.gitlabpages.inria.fr/doc/entrypoint.html">entry point documentation</a> for further explanation.'),
+            help_text=mark_safe('This is the <a href="https://allgo.gitlabpages.inria.fr/doc/deploy.html#entrypoint">command executed when allgo runs a job</a> for this app.'),
             initial="/home/allgo/entrypoint")
 
     def __init__(self, *args, **kwargs):