Publish and check the project¶

This guide publishes the tutorial and the project, and checks both in the web app as a volunteer. Follow the steps in order, first on stage (see Stage and production). You need the tutorial from Create the tutorial and your manager account.

1. Publish the tutorial¶

1. In the manager, open the tutorial: click Tutorials in the top menu and click its title.
2. Click Publish at the top right.
3. Click Confirm. The Publish and Discard buttons disappear, and the tutorial is published (observed in the manager).

Only a published tutorial can be attached to a project. Skip this step when you reuse a published tutorial.

2. Attach the tutorial to the project¶

1. Click Projects in the top menu and open your project.
2. Scroll down to Tutorial and click the field Select a tutorial for this project.
3. Click your tutorial. Only tutorials of the same project type are listed.
4. Click Update project at the bottom of the page.

3. Publish the project¶

1. Click Publish at the top right.
2. Click Confirm.

The project moves to Published, and the top right shows Withdraw, Finish and Pause.

4. Open the project in the web app¶

1. Open the web app of the same environment: https://web.mapswipe.org/dev/ for stage, https://web.mapswipe.org/ for production.
2. To sign in, click the person icon at the top right (Sign In/Sign Up) and sign in with your MapSwipe account, the same one as for the manager (observed in the web app).
3. Click Projects at the top. Scroll to your project; new projects are near the end of the list (observed in the web app).
4. Click Contribute on your project. The project details open.
5. Click Contribute again. The tutorial opens on the How to contribute? tab.

5. Check the tutorial¶

The tutorial has a tab for How to contribute?, one tab per information page, and Tutorial. Close leaves the tutorial at any time (observed in the web app).

1. Click the tab of your information page, for example Solar panels, and check the text and the image.

2. Click Tutorial. The first scenario shows your Instruction message above the tile.

3. Tap a cell. The Hint message replaces the instruction. Each tap on a cell moves it to the project's next answer, for example Single Feature, Multiple Features, then No (source).

4. Tap the cells that hold the object, the same cells you marked in the tutorial builder. When all cells match, the Success message and Next task appear.

   The web app shows the hint after the first tap, until all cells are right, and Show answer after two taps while a cell is still wrong (source). A scenario without the object shows the success message right away (observed in the web app).

5. Click Next task for each scenario. After the last one, the app shows "You're ready to start MapSwiping!".

6. Click Start mapping. The project tiles follow, one per screen. Tap cells, move with the arrows, and click the save icon at the end of the group (observed in the web app).

6. Create the project on production¶

When the project and the tutorial work on stage, create them again on production with the same steps, from Create a Locate project. Under Organization, pick fAIrSwipe Grantees there too. Volunteers map on production.

7. Finish the project¶

A project reaches 100% when every tile has been seen by as many volunteers as the verification number. The manager accepts 3 or more (observed in the manager), so one account alone can't complete a project.

1. Open the project in the manager.
2. Click Finish at the top right and Confirm. The confirmation says the action is irreversible. Finish works before the project reaches 100% (observed in the manager).

The project moves to Finished and leaves the volunteers' project list. Its results stay available.