Skip to main content

Titles [H1]

For CoMapeo [app]v8

[Hero - image size/]

20241127_160355.jpg

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

💡 Tip: This is information that will not determine the success of the steps, but you consider relevant recommendations for users.

Example

💡 Tip: You can also add audio recordings to Observations to provide context and narratives. (This is information that will not determine the success of the steps, but you consider relevant recommendations for users.)

text with line break


👉🏽 More. Use this emoji for information that you would normally add as a bracket or parenthesis. Not essential but complementary.

Example:

👉🏽 CoMapeo in Action: Learn how this feature is used to document biodiversity

In troubleshooting

📗 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

  1. numbered steps
  2. second step

👉 Complementary information for prevention or reduced issues

🔗 Go to Gathering the right equipment (for different pages in documentation)

Blog | Stability & Co-Design: Our CoMapeo Release Strategy


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

android
  • png
  • added to library

gps accuracy (partial or referencial image perhaps?) “nice to have” [can wait]

IMG_20251013_181234.jpg

  • png
  • added to library
i (info)
  • png
  • added to library
icon---located my location
  • png
  • added to library

comapeo-capture-low[comapeo-capture-low]
  • png
  • added to library
observation list
  • png
  • added to library
icon-map-low 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 [ comapeo-save-low]
  • png
  • added to library
icon-coordinates-lowcoordinates
  • 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 comapeo-save-low save!

select comapeo-add-photo-low add photo to open camera

Precision of the icon-coordinates-lowcoordinates 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]

Can gifs work too?

unlucky-duck.gif

no content between h tags below

Instruction formatting (H3)

Choosing format for instructions (H2)

with content below

2nd Instruction formatting (H3)

with content below

2nd Choosing format for instructions (H2)

Example 1

Step 1: Select **icon-add-audio-low**add Audio. Recording will begin immediately

1000029410.jpg

👀

If this is your first time recording audio with CoMapeo, you will need to grant permission to use this feature. 1000029411.jpg

1000029412.jpg

Step 2. Select ⏹️ stop when done

1000029413.jpg


Step 3. Review recording. Choose to ▶️ listen to the recorded audio, icon-add-audio-lowadd another audio, or ➡️ continue to edit the observation

1000029414.jpg


Example 2

👣 Walkthrough

👣 Step 1

Select icon-add-audio-lowadd Audio. Recording will begin immediately

1000029410.jpg

⚠️ If this is your first time recording audio with CoMapeo, you will need to grant permission to use this feature. 1000029411.jpg

1000029412.jpg

🟢 Step 2 Select ⏹️ stop when done

1000029413.jpg

👉🏽 Step 3 Choose to ▶️ listen to the recorded audio, icon-add-audio-lowadd another audio, or ➡️ continue to edit the observation

1000029414.jpg

Example 3
⚠️

👣 Step 1: Start recording audio Select icon-add-audio-lowadd Audio. Recording will begin immediately

1000029410.jpg


If this is your first time recording audio with CoMapeo, you will need to grant permission to use this feature.

1000029411.jpg

1000029412.jpg


Step 2: Stop recording

Select ⏹️ stop when done

1000029413.jpg


Step 3: Choose next step

Choose to ▶️ listen to the recorded audio, icon-add-audio-lowadd another audio, or ➡️ continue to edit the observation

1000029414.jpg



Example 5

👣 Step by step

  1. Start recording audio

Select icon-add-audio-lowadd Audio. Recording will begin immediately

1000029410.jpg


If this is your first time recording audio with CoMapeo, you will need to grant permission to use this feature.

1000029411.jpg

1000029412.jpg


  1. Stop recording

Select ⏹️ stop when done

1000029413.jpg


  1. Choose next step

Choose to ▶️ listen to the recorded audio, icon-add-audio-lowadd another audio, or ➡️ continue to edit the observation

1000029414.jpg

⚫ the last grey callout