Skip to content

Commit

Permalink
docs: update docs home page to use ref links
Browse files Browse the repository at this point in the history
  • Loading branch information
spwoodcock committed Jan 13, 2024
1 parent fc10f53 commit 1b0e4de
Showing 1 changed file with 68 additions and 31 deletions.
99 changes: 68 additions & 31 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
# 🤗 Welcome To The Field Mapping Documentation 🤗

### _**What is ONE thing all the greatest solutions out there have in common?**_
## What is ONE thing all the greatest solutions out there have in common?

They never forget the people they are building for (^^) :smiley:

So who are we building field mapping solutions for? In short, we build solutions for:
So who are we building field mapping solutions for? In short, we build solutions
for:

## The field mapping manager (coordinating field mapping)

Expand All @@ -24,7 +25,11 @@ steps, including:
- **_Coordination:_** The field mapping manager must coordinate the activities
of the field mappers, ensuring that they are working together
effectively and efficiently.
<img align="left" width="500px" src="https://user-images.githubusercontent.com/107098623/194864145-598d6212-9e0b-4c9d-ba90-92e5cd3fa488.png"/>
<img
align="left"
width="500px"
src="https://user-images.githubusercontent.com/107098623/194864145-598d6212-9e0b-4c9d-ba90-92e5cd3fa488.png"
/>

## The field mapper (collecting data)

Expand Down Expand Up @@ -61,13 +66,13 @@ errors. The validator faces a number of challenges and issues, including:
validation protocols and guidelines, ensuring that the data meets a high
level of quality and accuracy.

[Click here](https://miro.com/app/board/uXjVPX4XLcI=/?moveToWidget=3458764534814634286&cot=14) to see an overview of who you are building for, which actions they take and some ideas for solutions!
[Click here][1] to see an overview of who you are building for, which actions
they take and some ideas for solutions!

Below is an overview of the user flow of the **Field Mapper**, the **Mapping Coordinator / Field Mapping Manager** and the **Validator**.
Below is an overview of the user flow of the **Field Mapper**, the
**Mapping Coordinator / Field Mapping Manager** and the **Validator**.

<!-- ![Screenshot 2022-10-10 at 14 14 23](https://user-images.githubusercontent.com/107098623/194864145-598d6212-9e0b-4c9d-ba90-92e5cd3fa488.png) -->

# The Field Mapping Manager (The person who coordinates field mapping)
## The Field Mapping Manager (The person who coordinates field mapping)

The **Field Mapping Manager** is tasked with coordinating all mapping
activities, ensuring that **Field Mappers** are safe and qualified to
Expand All @@ -77,7 +82,8 @@ Manager** has to consider 3 main activities:
1. **Pre-field data collection activities**
- Setting up and testing tools
- Creating a form
- Training field mappers (making sure that they understand the form and how to fill it)
- Training field mappers (making sure that they understand the form and how
to fill it)
- Creating an area of interest within the location to be mapped
2. **Data collection activities**
- Preparing daily, weekly and monthly activity plans
Expand All @@ -88,15 +94,18 @@ Manager** has to consider 3 main activities:
- Giving and recieving team feedback
- Updating tools and methodoligies

If you want more information, click on [this virtual whiteboard!](https://miro.com/app/board/uXjVPX4XLcI=/?moveToWidget=3458764535077658755&cot=14) to see all the steps a **Field Mapping Coordinator or Manager** goes through. Here's a sneak-peek:
If you want more information, click on [this][2] virtual whiteboard! to see all
the steps a **Field Mapping Coordinator or Manager** goes through.
Here's a sneak-peek:

- See also data collection approach [>>in this training guide<<](https://hotosm.github.io/pdc-documentation/en/pages/01-osm-field-surveyor-guideliness/01-metodologi-pengumpulan-data/01_metodologi_pengumpulan_data/)
- See also data collection approach in [in this training guide<<][3]

![Screenshot 2022-10-10 at 13 48 40](https://user-images.githubusercontent.com/107098623/194859584-31dae52a-e918-4cd8-9071-24791750d6bb.png)
![Field mapping coordinator][4]

# The Field Mapper (The person who collects data)
## The Field Mapper (The person who collects data)

The **Field Mapper** surveys locations and collects data from them. The basic work flow that a **Field Mapper** has to consider is as follows:
The **Field Mapper** surveys locations and collects data from them. The basic
work flow that a **Field Mapper** has to consider is as follows:

1. Find a phone that:
- Works well with the app.
Expand All @@ -105,43 +114,59 @@ The **Field Mapper** surveys locations and collects data from them. The basic wo
3. Access the **OSM** registration site and register.
4. Follow the tutorial and choose a campaign.
5. Select a task from the campaign.
6. Launch the map app which allows you to see the moving map of the points that you are now responsible for.
7. Complete each point within the task, making sure to answer the questions in the form for each one.
6. Launch the map app which allows you to see the moving map of the points that
you are now responsible for.
7. Complete each point within the task, making sure to answer the questions in
the form for each one.
8. Send the data of each point until the task is complete.
9. Once the task is complete, signal that your task is finished. This lets the **Validator** know that they can check the quality of your data.
9. Once the task is complete, signal that your task is finished. This lets the
**Validator** know that they can check the quality of your data.

If you want to see this workflow in more detail, click on
[this virtual whiteboard!][5]

If you want to see this workflow in more detail, click on [this virtual whiteboard!](https://miro.com/app/board/uXjVPX4XLcI=/?moveToWidget=3458764535074723879&cot=14) Here's a sneak-peek:
Here's a sneak-peek:

<img align="centre" width="1000px" height="600px" src="https://user-images.githubusercontent.com/107098623/194867381-53813f19-71b1-4342-866f-10c963b7460b.png"/>
<!-- ![Screenshot 2022-10-10 at 14 29 53](https://user-images.githubusercontent.com/107098623/194867381-53813f19-71b1-4342-866f-10c963b7460b.png) -->
<img
align="centre"
width="1000px"
height="600px"
src="https://user-images.githubusercontent.com/107098623/194867381-53813f19-71b1-4342-866f-10c963b7460b.png"
/>

# The Validator (The person who checks the quality of data collected)
## The Validator (The person who checks the quality of data collected)

![Screenshot 2022-10-20 at 12 14 16](https://user-images.githubusercontent.com/107098623/196922048-c156b8ed-7f1a-404b-a636-fcfca2c0b328.png)
![osm data collection][6]

The **Validator** does the following tasks to ensure that quality data is collected and uploaded to **OSM**:
The **Validator** does the following tasks to ensure that quality data is
collected and uploaded to **OSM**:

- Logs into task manager
- Checks how many tasks need validation
- Checks tasks for errors
- Stops mappers that make mistakes and explains how they can fix their errors
- Lowers supervision on good mappers in order to spend more time on those who are stuggling
- Lowers supervision on good mappers in order to spend more time on those who
are stuggling
- Uploads high quality data to **OSM** and marks completed tasks as **done**

Some of the pain points and struggles faced by the **Validator** include:

- Lack of validators (the **Validator** is often the same person as the **Field Mapping Manager**)
- Lack of validators (the **Validator** is often the same person as the
**Field Mapping Manager**)
- Many areas of the world are still unmapped on online commercial maps
- The quality of maps needs to improve
- The more developers complicate tools, the more they reduce the usefulness of the tools
- The more developers complicate tools, the more they reduce the usefulness
of the tools

For more details, click on [this virtual whiteboard!][7]

For more details, click on [this virtual whiteboard!](https://miro.com/app/board/uXjVPX4XLcI=/?moveToWidget=3458764535077160536&cot=14) See sneak-peek below.
See sneak-peek below.

- See also all steps of validation [>>in this training guide<<](https://hotosm.github.io/pdc-documentation/en/pages/04-data-validation-and-quality-assurance/02-penggunaan-josm-untuk-validasi-data-survei/josm-for-validating-survey-data/)
- See also all steps of validation [>>in this training guide<<][8]
- See also global validator Becky's OSM diary which features:
["Common Feedback I give while Validating Building Projects"](https://www.openstreetmap.org/user/Becky%20Candy/diary)
["Common Feedback I give while Validating Building Projects"][9]

![Screenshot 2022-10-10 at 14 45 39](https://user-images.githubusercontent.com/107098623/194870234-fa9497cb-d9e4-43ff-b7dd-ad731f8be488.png)
![validator flow][10]

Some of the key points covered are:

Expand All @@ -150,4 +175,16 @@ Some of the key points covered are:
- Ensuring consistency with existing data and standards
- Providing clear and constructive feedback to field mappers and coordinators

Overall, understanding the needs and considerations of each of these three user groups is essential for building effective field mapping solutions.
Overall, understanding the needs and considerations of each of these three user
groups is essential for building effective field mapping solutions.

[1]: https://miro.com/app/board/uXjVPX4XLcI=/?moveToWidget=3458764534814634286&cot=14
[2]: https://miro.com/app/board/uXjVPX4XLcI=/?moveToWidget=3458764535077658755&cot=14
[3]: https://hotosm.github.io/pdc-documentation/en/pages/01-osm-field-surveyor-guideliness/01-metodologi-pengumpulan-data/01_metodologi_pengumpulan_data/
[4]: https://user-images.githubusercontent.com/107098623/194859584-31dae52a-e918-4cd8-9071-24791750d6bb.png
[5]: https://miro.com/app/board/uXjVPX4XLcI=/?moveToWidget=3458764535074723879&cot=14
[6]: https://user-images.githubusercontent.com/107098623/196922048-c156b8ed-7f1a-404b-a636-fcfca2c0b328.png
[7]: https://miro.com/app/board/uXjVPX4XLcI=/?moveToWidget=3458764535077160536&cot=14
[8]: https://hotosm.github.io/pdc-documentation/en/pages/04-data-validation-and-quality-assurance/02-penggunaan-josm-untuk-validasi-data-survei/josm-for-validating-survey-data
[9]: https://www.openstreetmap.org/user/Becky%20Candy/diary/399055
[10]: https://user-images.githubusercontent.com/107098623/194870234-fa9497cb-d9e4-43ff-b7dd-ad731f8be488.png

0 comments on commit 1b0e4de

Please sign in to comment.