Skip to content
Snippets Groups Projects

start to work on Help page

Merged Jean CURY requested to merge create_doc into dev
6 files
+ 49
3
Compare changes
  • Side-by-side
  • Inline
Files
6
+ 49
3
@@ -20,7 +20,7 @@ On the web service page, users can upload their fasta file. A user can upload mu
Users need to provide a name for the job being submitted before clicking on the submit button.
Once a job is submitted, the page is redirected to the Analyses panel where results of the past runs can be found.
![webservice_interface](/help/webservice_interface.jpg)
![webservice_interface](/help/webservice_interface.jpg){max-width=750px}
The result consists in 3 tables :
- Systems table : One system per line. On the column type, there is the name of the system, and one can click on it to be redirected to the corresponding wiki page.
@@ -29,7 +29,7 @@ The result consists in 3 tables :
## Contributing to the Wiki
### Create an account
### 1/ Create an account
The wiki is based on gitlab pages, and we are using the gitlab's instance of the Pasteur Institute. To contribute, users need to be part of the project.
@@ -37,5 +37,51 @@ On every page, there is a button at the bottom proposing to "Edit on Gitlab". It
But on the first try, the following dialog will be prompted. If you have a Pasteur account, chose 1, otherwise chose 2. In External account, you can connect with a third-party account such as Github, bitbucket or google.
If you have neither, register on Github first (it's always useful).
![Register](/help/register_1.png)
![Register](/help/register_1.png){max-width=750px}
Once your account is created, you need to request access to the project, on the [gitlab page of the wiki](https://gitlab.pasteur.fr/mdm-lab/wiki) of the repo, there is a small link to request access.
![Request Access](/help/Request_access.png){max-width=600px}
Click, and wait for an admin approval.
### 2/ Edit a page.
Once you have access to the project (the previous step is done once), you can edit easily each page of the wiki, and post issues (if you have question about something or remarks with anything from content to design).
To edit a page, just click on the Edit on Gitlab button at the bottom of every page of the wiki, and it will lead you to the corresponding page of the wiki.
From this page, you can :
1. Edit the text you'd like
2. Preview the change you've done (final modification might a bit different, especially if you use plugins to view citations or pdb structures)
3. Once you've finished you edits, you can specify what you did (e.g. "Re-wrote history of defense systems")
4. This field is for the branch name, you can let it with the default value, or specify a more meaningful name (note that it's good to have your user name in the branch name so we can)
![Edit a page](/help/Edit_page.png){max-width=750px}
Then it asks you to create a merge request.
In other words, the modifications you made will not be reflected on the website until a few automatic checks passed (which should be ok since you modified only some text) and that another person reviewed the change, and accept the merge request.
To do so, just fill in the description (1) of what you did, or anything that you would like the person who will accept the merge request to know, and just hit (2) "Create a merge request".
![Create MR](/help/Create_MR.png){max-width=750px}
### 3/ Review a Merge Request
You can review other person's merge request by going the [merge request's pages](https://gitlab.pasteur.fr/mdm-lab/wiki/-/merge_requests).
On a given page, you can see what modifications where made for this merge request (1), then you can comment if you have anything to say (2 and 3).
And finally, you can approve (4) the MR if you find it worth publishing on the website.
![review a MR](/help/Review_MR.png){max-width=750px}
If you want to modify further the file or other file within the same merge request, go to "Changes (1)", and then click on the 3 little dots (see arrow on image) and then "Edit in single-file editor", or "Open in Web IDE".
![Edit_MR](/help/Edit_MR.png){max-width=750px}
The Web IDE editor allows you to edit multiple file at once for a given commit.
## Contribute to the code
Contribution to the code and design are open. Please read the [README](https://gitlab.pasteur.fr/mdm-lab/wiki) on how to deploy the website locally (and see the modification you're doing live).
\ No newline at end of file
Loading