Titles [H1]
For CoMapeo [app]v8
[Hero - image size/]
There is a sentence or brief paragraph to describe the topic. For descriptions with lists of details use bullets. This is a list of features of headers:
- Keep title short and simple.
- Use verb action-oriented headers, ie. “Understanding Exchange”.
Use feature names clearly. Capitalize them always and write them in bold within introduction and descriptive paragraphs. and especially when mentioned for the first time on a page.
Headings [H2]
Break down large chunks of text into smaller paragraphs. This makes information more accessible to diverse kinds of readers.
If your section is more than two paragraphs long, consider adding subtitles to improve readability
Sub-headings [H3]
Headings and subheadings become linkable so someone can be pointed to a specific section of a page. This can happen in page using the right side bar, or as static URL opened in a new browser
How to use capitalization:
- Use standard capitalization according to language grammer.
- Capitalize the name of features in EN, ES and PT
- Bold the name of features when introduced in paragraphs
3rd level headings can be formatted as bold text.
Manually styled lists
→ Arrow for recommendation List
✔️ Check list items
text with line break
💡 Tip: This is information that will not determine the success of the steps, but you consider relevant recommendations for users.
👉🏽 More. Use this emoji for information that you would normally add as a bracket or parenthesis. Not essential but complementary.
👣 Steps: Manual entry of coordinates
Step 1: Select Bold name of action with 🔳 emoji (custom CoMapeo emojis coming soon)
Step 2: Explaining more involved steps [add a soft line break using shift+enter]
This formatting is useful if more notes are requred for a specific step requiring additional description or choice points requiring more detail
Links
for different pages in documentation
🔗 Go to Name of page in bold with added link
🔗 Blog | Stability & Co-Design: Our CoMapeo Release Strategy
Example [H1]
For CoMapeo Mobile v8
What is Exchange?
Exchange is the signature feature of CoMapeo that allows for data to securely travel over a local WiFi network between all connected devices that are part of the same project, even when offline.
Sub-headings [H3]
Headings and subheadings become linkable so someone can be pointed to a specific section of a page. This can happen in page using the right side bar, or as static URL opened in a new browser
3rd level headings
Manually styled lists
→ Arrow for recommendation List
✔️ Check list items
💡 Tip: You can also add audio recordings to Observations to provide context and narratives.
👉🏽 CoMapeo in Action: Learn how this feature is used to document biodiversity
👣 Steps: Start recording audio
Step 1: Select
add audio
Recording will begin immediately.
Note: If this is your first time recording audio with CoMapeo, you will need to grant permission to use this feature.
Step 2: Stop recording
Select ⏹️ stop when done
Step 3: Choose next step
Choose to ▶️ listen to the recorded audio,
Related Content
This feature is related to a few other features or documents :
🔗 Blog | Stability & Co-Design: Our CoMapeo Release Strategy
🔗 Go to Gathering the right equipment (for different pages in documentation)
🔗 Go to Exploring the Observation List (this link does not exsist yet)
🔗 Go to Reviewing an Observation (this link does not exsist yet)
Having problems?
Common issues with track are associated with … doing this…. will help reduce this…
🔗 Go to Troubleshooting Gathering observation (this link does not exsist yet)
Coming Soon
[Known improvements and tentative timelines]
In troubleshooting page there is exceptional formatting (TBC)
📗 Solution: Make sure your device has enough free space available
Use this emoji for information in #Troubleshooting for recommended solutions. The line above is H3 so it can get a # and be linked to directly. This line is about what this solution does, and perhaps why it works.
👣 Step by step instructions
✔️ Check list items
- numbered steps
- second step
👉 Complementary information for prevention or reduced issues
Emoji shortlist
Our library of emojis for docs (headers and body)
👇 On this page (TOC)
👉🏽 [point] → More
💡 [light] → recommendation
👀 [ eyes]→ pay attention to
👣 [footprints] → walkthrough
✔️ [grey check for checklist] → checklist items
✅ [green check mark] → verified (or good practices?)
🚧 [under construction] → feature development note
- bullets as unordered list to infer inclusion or options
→ [”-” + ”>”] → recommendation list item
Our library of emojis for instruction (maybe
▶️ [play]
⏹️ [square stop]
❌ [red X]
🗑️ [trash bin]
➕ [plus] to use as “add” when combined with details, photo[camera] & audio[mic] (i.e ➕ 📷)
PLUS ⬇️
Customized emojis for comapeo UI elements - checklist for Untitled
- png
- added to library
gps accuracy (partial or referencial image perhaps?) “nice to have” [can wait]
- png
- added to library
i (info)
- png
- added to library
my location
- png
- added to library
[comapeo-capture-low]
- png
- added to library
observation list
- png
- added to library
map (black)
- png
- added to library
camera
- png
- added to library
tracks
- png
- added to library
details
- png
- added to library
audio
- png
- added to library
[ comapeo-save-low]
- png
- added to library
coordinates
- png
- added to library
share
- png
- added to library
edit [pen]
- png
- added to library
delete [trash bin]
- png
- added to library
back arrow
- png
- added to library
exit X
- png
- added to library
Menu/device settings
- png
- added to library
app setting
- png
- added to library
data privacy [lock shield]
- png
- added to library
coordinate system
- png
- added to library
Background map
- png
- added to library
language
- png
- added to library
security [grid shield]
- png
- added to library
start collaborating - (start new project) [wait for icon audit]
- png
- added to library
change project - (formerly all) projects [wait for icon audit]
- png
- added to library
project categories - (to update category set) [wait for icon audit]
- png
- added to library
Import categories/choose file - (open file android picker) [wait for icon audit]
- png
- added to library
invite collaborator [wait for icon audit]
- png
- added to library
coordinator (roles icon) - this is about the decision point
- png
- added to library
participant (roles icons)
- png
- added to library
warning exclamation
- png
- added to library
exchange
- png
- added to library
wifi symbol
- png
- added to library
Remote archiver
- png
- added to library
Samples:
Tap save!
select 
add photo to open camera
Precision of the coordinates for your observation will improve over time.
emojis we are not using
Let’s get wild!! Here is inlne emojis ▶️ [play] ⏹️ [square stop] ❌ [red X] 🗑️ [trash bin] 💾 [3 inch floppy save]
⛔ [ no entry]
🚫 [prohibited]
🟢 [green circle], 🟡 [ yellow circle], 🔴 circle
❓[ red question mark]
⭕ [ heavy red circle]
🔵 [blue circle]
⚠️ [ warning]
🏁 [racing flag]
🔄 [cycle loop]
🧩 [ puzzle peice]
💬 [speech ballon]
🐾 [ paw prints]
⏳[hourglass]
📢 [public loudspeaker]