Skip to content

Conversation

sloncocs
Copy link
Contributor

  • make sure that outreach happens
  • when merging, double check that the publication date is today

@sloncocs sloncocs added the documentation Improvements or additions to documentation label Apr 15, 2025
@sloncocs sloncocs requested a review from agrabeli April 15, 2025 08:48
@sloncocs sloncocs self-assigned this Apr 15, 2025
Copy link

vercel bot commented Apr 15, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
ooni-org ✅ Ready (Inspect) Visit Preview 💬 Add feedback May 14, 2025 10:34am

Copy link
Member

@aanorbel aanorbel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The guide looks amazing so far.

My recommendation is to have a somewhat consistent size for the mobile screenshots (the width).

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure performance failing in this screenshot is intentional.
I can provide the same screenshot we used in the store so its more consitent.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think it is a problem that it is failing because users may see this result as well, and if we update this screenshot, we will need to update all screenshots in this section

Copy link

@sdsantos sdsantos left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The index above works for sending the user to a specific section. But it would be nice if the section headers would also be linked to the anchor, so we could just click it and copy the URL.

### [Manually measuring the blocking of instant messaging apps](#manually-measuring-the-blocking-of-instant-messaging-apps)

But maybe the markdown processor we're using supports:

### [Manually measuring the blocking of instant messaging apps][]


Step 2. Depending on your operating system (Android, iOS, F-Droid), tap the relevant app store button.

Google Play/F-Droid apply to the same operative system, Android. The choice in that case it's more of convenience vs privacy. Not a big deal, since most people that know F-Droid will know if they want to use that option. But the phrase is not entirely correct, so I wanted to raise that.


Step 6. If you would like the app to collect the measurements automatically, tap the Sounds great button.

The button now only says "Yes"


Step 9. Tap OK.

The button now says "Let's go".


Installed OONI Run links. Beneath all the cards you will see a section with the OONI Run links you have installed on your app. You can read more about OONI Run links here.

Note: You will only see this is there's any installed link. After onboarding, the user won't have any.


The section "Manually measuring the blocking of circumvention tools" seems to be missing the "You are now running OONI’s..." paragraph.


In the above example, we have enabled 5 categories (“LGBTQI”, “Political Criticism”, “News Media”, “Human Rights”, “Communication tools”).

The screenshot has:

  • LGBTQ+ (slightly different acronym)
  • Human Rights Issues (Issues at the end)
  • No "Communication tools"

The "Install the link" screen looks a bit different now, but instructions are still correct.


For "Deleting test results" you can also use the clear button on the top right corner of the "Test Results" screen. Clearing from the Settings clears more stuff like logs. But in practice, the user won't tell the difference.


The Settings "Notifications" screen has disappeared with ooni/probe-multiplatform#652

@sloncocs
Copy link
Contributor Author

sloncocs commented May 6, 2025

I addressed all content-related feedback.

@majakomel would you have a moment to look into markdown and image formatting? Maybe there is a way to adjust the mobile screenshots to the same size automatically?

@sloncocs sloncocs merged commit 60c9cd9 into master May 15, 2025
6 checks passed
@sloncocs sloncocs deleted the upd-ooni-probe-mobile-user-guide-en branch May 15, 2025 13:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants