From 5c99d0583e9547581572d53e06431370351be105 Mon Sep 17 00:00:00 2001 From: spwoodcock Date: Fri, 8 Nov 2024 12:57:15 +0000 Subject: [PATCH] docs: update structure of faq to use markdown headings --- docs/about/faq.md | 143 ++++++++++++++++++++++------------------------ 1 file changed, 69 insertions(+), 74 deletions(-) diff --git a/docs/about/faq.md b/docs/about/faq.md index f23f3a0b00..518a6fc79c 100644 --- a/docs/about/faq.md +++ b/docs/about/faq.md @@ -2,17 +2,17 @@ ## General -**Q:** What is the Field Mapping Tasking Manager (FMTM)? +### What is the Field Mapping Tasking Manager (FMTM)? -**A:** The Field Mapping Tasking Manager (FMTM) is an online platform that +The Field Mapping Tasking Manager (FMTM) is an online platform that allows contributors to participate in mapping projects related to humanitarian and development work. --- -**Q:**: What problem does it solve? +### What problem does it solve? -**A:** There are a few great tools for adding tags to OpenStreetMap in the field +There are a few great tools for adding tags to OpenStreetMap in the field already. FMTM is not aiming to compete with these tools, but instead has two goals: 1. To solve the challenge of effectively coordinating mappers to work together @@ -25,33 +25,32 @@ already. FMTM is not aiming to compete with these tools, but instead has two goa --- -**Q:**: Don't other tools do similar things? - -**A:** +### Don't other tools do similar things? !!! note The following is the personal opinion from HOT staff members, and provides some context for the reasoning behind creating the FMTM. -- _QField_: the mobile extension of QGIS, literally a GIS on your phone. +- **QField**: the mobile extension of QGIS, literally a GIS on your phone. This is an excellent tool for what it does: collecting geometries in the field, alongside unstructured attributes like any other GIS. This is in contrast to tools such as ODK or Kobo that mostly collect structured survey data, by asking the user sets of predefined questions. -- _Fulcrum_: proprietary / paid. Appears to be more focused on data collection in - engineering and environmental contexts, mostly for for-profit companies. +- **Fulcrum**: proprietary / paid. Appears to be more focused on data collection + in engineering and environmental contexts, mostly for for-profit companies. We could possibly learn from them, but they are closed-source. -- _ArcGIS Field Maps_: proprietary / paid, similar applications to Fulcrum, but not - necessarily designed for text/question based surveys. +- **ArcGIS Field Maps**: proprietary / paid, similar applications to Fulcrum, + but not necessarily designed for text/question based surveys. -- _ArcGIS Survey123_: proprietary / paid, more appropriate for our use case of field - survey data collection. However, not an option due to it's closed nature. +- **ArcGIS Survey123**: proprietary / paid, more appropriate for our use case + of field survey data collection. However, not an option due to it's closed + nature. -- _KoboCollect_: fork of ODK, same mobile app essentially, but different back end. +- **KoboCollect**: fork of ODK, same mobile app essentially, but different back end. Has a slightly complicated relationship with ODK, formerly taking from the community and not giving back. However, they now contribute financially to ODK, and definitely have some great ideas in this field. In our opinion, ODK is more @@ -59,17 +58,17 @@ already. FMTM is not aiming to compete with these tools, but instead has two goa free public server backed by the UN, as a general public good, and is widely adopted as a result. -- _Ona_: proprietary software, with a slightly shady history of building open-source +- **Ona**: proprietary software, with a slightly shady history of building open-source tools using NGO money, then changing the license to a closed model. Were legally forced to open-source the original work done, but everything since has been closed. Have since done some great work around data management and analytics, however, their main objective is not the same as FMTM: coordinating field mapping. -- _MapCampaigner_: a now dead project. In our opinion, this tool certainly helped +- **MapCampaigner**: a now dead project. In our opinion, this tool certainly helped the Monitoring & Evaluation team for field data collection projects, but did not add anything innovative in terms of user experience for the the field mapper. -- _POSM_ (+ OpenMapKit): a now dead project. However, this was an excellent technical +- **POSM** (+ OpenMapKit): a now dead project. However, this was an excellent technical advancement and concept for the open mapping sector. It was arguably the first good solution for field mobile data collection (using ODK and other tools underneath). OpenMapKit was the data collection system, while POSM was the offline @@ -87,17 +86,15 @@ already. FMTM is not aiming to compete with these tools, but instead has two goa deployment on a small field-based device (e.g. RaspberryPI), and is currently in our roadmap to explore this approach further. -- _CommCare_: technically open-source, developed by Dimagi, but built in such a way - to make it quite difficult to self-host. Very good at collection of "longitudinal - data" (data over time), which ODK has only recently began to address with Entities. - We should definitely look for opportunities to learn from / collaborate into the - future. +- **CommCare**: technically open-source, developed by Dimagi, but built in such + a way to make it quite difficult to self-host. Very good at collection of + "longitudinal data" (data over time), which ODK has only recently began to + address with Entities. We should definitely look for opportunities to learn + from / collaborate into the future. --- -**Q:**: So why should I use FMTM over these other tools? - -**A:** +### So why should I use FMTM over these other tools? You might not need to! It depends if you are simply collecting data in the field as an individual, or are trying to coordinate amongst @@ -109,9 +106,7 @@ collection ecosystem. Instead, it is a higher level tool, aimed at --- -**Q:**: What is the relationship between FMTM and Kobo? - -**A:**: +### What is the relationship between FMTM and Kobo? - Kobo is not an FMTM competitor, it's an ODK competitor. - FMTM uses ODK underneath for reasons explained above, but due to the popularity @@ -146,9 +141,9 @@ collection ecosystem. Instead, it is a higher level tool, aimed at ## For Users -**Q:** Do I need to create an account to use the FMTM Web App? +### Do I need to create an account to use the FMTM Web App? -**A:** Mappers have no requirement to sign up, easing the process of mapping +Mappers have no requirement to sign up, easing the process of mapping for those that are impatient to get started! However, to use the FMTM project management site it is recommended to sign in with OSM. This is so data uploaded to OSM can be attributed to a user. Notifications are also sent via OpenStreetMap @@ -156,50 +151,50 @@ messages/emails. --- -**Q:** How do I contribute to a mapping project on the FMTM Web App? +### How do I contribute to a mapping project on the FMTM Web App? -**A:** To contribute to a mapping project on the FMTM Web App, you can +To contribute to a mapping project on the FMTM Web App, you can create an account, select a project of interest, and choose a task to work on. You can then use the mapping tools provided to complete the task. --- -**Q:** Can I work on multiple mapping tasks at the same time on the FMTM Web App? +### Can I work on multiple mapping tasks at the same time on the FMTM Web App? -**A:** Yes, you can work on multiple mapping tasks at the same time on the +Yes, you can work on multiple mapping tasks at the same time on the FMTM Web App, as long as you can commit the necessary time and effort to each task. --- -**Q:** How do I know if my mapping work on the FMTM Web App is accurate? +### How do I know if my mapping work on the FMTM Web App is accurate? -**A:** The FMTM Web App has a validation process where other contributors +The FMTM Web App has a validation process where other contributors review and validate the mapping work. This helps to ensure the accuracy of the mapping data. --- -**Q:** Can I provide feedback on a mapping project on the FMTM Web App? +### Can I provide feedback on a mapping project on the FMTM Web App? -**A:** Yes, you can provide feedback on a mapping project on the FMTM Web +Yes, you can provide feedback on a mapping project on the FMTM Web App by leaving a comment on the project page or contacting the project manager. --- -**Q:** How do I download mapping data from a project on the FMTM Web App? +### How do I download mapping data from a project on the FMTM Web App? -**A:** To download mapping data from a project on the FMTM Web App, you +To download mapping data from a project on the FMTM Web App, you can select the project of interest and click on the "Export" button on the project page. --- -**Q:** Can I use the mapping data from the FMTM Web App for my own research or projects? +### Can I use the mapping data from the FMTM Web App for my own research or projects? -**A:** The mapping data on the FMTM Web App is generally open and +The mapping data on the FMTM Web App is generally open and available for use, but it is important to check the specific project requirements and licenses before using the data for your own research or projects. @@ -208,75 +203,75 @@ or projects. ## For Contributors -**Q:** How can I become a contributor to the FMTM? +### How can I become a contributor to the FMTM? -**A:** To become a contributor to the FMTM, you can create an account on +To become a contributor to the FMTM, you can create an account on the platform and join a mapping project. --- -**Q:** Who can contribute to FMTM? +### Who can contribute to FMTM? -**A:** Anyone can contribute to FMTM. It is an open-source project, and +Anyone can contribute to FMTM. It is an open-source project, and contributions from developers, designers, and other contributors are always welcome. --- -**Q:** What kind of contributions can I make to FMTM? +### What kind of contributions can I make to FMTM? -**A:** There are several ways you can contribute to FMTM, including: +There are several ways you can contribute to FMTM, including: -Development: If you have experience in web development, you can +**Development**: If you have experience in web development, you can contribute by fixing bugs, adding new features, or improving the existing codebase. -Design: If you are a designer, you can contribute by improving the +**Design**: If you are a designer, you can contribute by improving the user interface, creating new design assets, or providing feedback on the existing design. -Documentation: If you have experience in technical writing, you can +**Documentation**: If you have experience in technical writing, you can contribute by writing documentation, tutorials, or other educational materials. -Testing: If you have experience in software testing, you can +**Testing**: If you have experience in software testing, you can contribute by testing the application and reporting bugs or suggesting improvements. -Translation: If you are fluent in a language other than English, you +**Translation**: If you are fluent in a language other than English, you can contribute by translating the application or its documentation into your language. --- -**Q:** What technologies are used in FMTM? +### What technologies are used in FMTM? -**A:** FMTM is built using several technologies, including FastAPI, +FMTM is built using several technologies, including FastAPI, Postgres, React, and web components. The codebase is written in Python & TypeScript mostly. --- -**Q:** How do I set up FMTM locally? +### How do I set up FMTM locally? -**A:** To set up FMTM locally, the simplest approach is likely using Docker. +To set up FMTM locally, the simplest approach is likely using Docker. If you are an advanced user, it is possible to run each service individually too. Please follow the instructions in the setup guide on this site. --- -**Q:** How can I report a bug or suggest a new feature for FMTM? +### How can I report a bug or suggest a new feature for FMTM? -**A:** You can report bugs or suggest new features by opening an issue on +You can report bugs or suggest new features by opening an issue on the FMTM repository on GitHub. Be sure to provide as much detail as possible, including steps to reproduce the bug, screenshots, or mockups for new features. --- -**Q:** How can I contribute to FMTM if I'm new to open source or web development? +### How can I contribute to FMTM if I'm new to open source or web development? -**A:** FMTM welcomes contributions from developers of all levels of +FMTM welcomes contributions from developers of all levels of experience, including those who are new to open source or web development. You can start by exploring the project's codebase and documentation, asking questions in the community, and contributing to @@ -286,49 +281,49 @@ help with your contributions. --- -**Q:** What are the benefits of contributing to the FMTM? +### What are the benefits of contributing to the FMTM? -**A:** Contributing to the FMTM allows you to help with important +Contributing to the FMTM allows you to help with important humanitarian and development work, while also developing your mapping skills and knowledge. --- -**Q:** Do I need to have prior mapping experience to contribute to the FMTM? +### Do I need to have prior mapping experience to contribute to the FMTM? -**A:** No, prior mapping experience is not required to contribute to the +No, prior mapping experience is not required to contribute to the FMTM. The platform provides training and resources to help new contributors get started. --- -**Q:** How do I know which mapping project to join? +### How do I know which mapping project to join? -**A:** The FMTM provides information about each project, including the +The FMTM provides information about each project, including the location, the organization sponsoring the project, and the mapping goals. Review the project information and choose a project that interests you. --- -**Q:** Can I work on multiple mapping projects at the same time? +### Can I work on multiple mapping projects at the same time? -**A:** Yes, you can work on multiple mapping projects at the same +Yes, you can work on multiple mapping projects at the same time. However, it is important to ensure that you can commit the necessary time and effort to each project. --- -**Q:** How do I get feedback on my mapping work? +### How do I get feedback on my mapping work? -**A:** The FMTM provides a validation process where other contributors +The FMTM provides a validation process where other contributors review and provide feedback on mapping work. You can also contact project managers or experienced contributors for additional feedback. --- -**Q:** How can I improve my mapping skills? +### How can I improve my mapping skills? -**A:** The FMTM provides training and resources to help you improve your +The FMTM provides training and resources to help you improve your mapping skills. You can also join mapping communities and forums to connect with other contributors and learn from their experiences.