Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update clarity and structure of step 2 in mi-10-steps.md #3523

Open
2 tasks done
Daunt-99 opened this issue Dec 19, 2024 · 3 comments · May be fixed by #3529
Open
2 tasks done

update clarity and structure of step 2 in mi-10-steps.md #3523

Daunt-99 opened this issue Dec 19, 2024 · 3 comments · May be fixed by #3529
Labels
mi first steps - mobile virtual interns

Comments

@Daunt-99
Copy link
Contributor

Please verify the following:

URL to the MDwiki page containing the problem

https://open-learning-exchange.github.io/#!pages/mi/mi-10-steps.md

Problem

In Step 2, the steps for testing the app are presented in one large paragraph, making them harder to follow.

Screenshots (when necessary)

No response

Proposed solution(s)

I suggest we break it into numbered or bulleted steps for better readability. For example we can do:

  • Launch the beta version of the app and grant necessary permissions
  • Tap the gear icon in the upper-right corner after passing the intro screen
  • Select the "planet learning" server to sync automatically.
  • Log in as a guest and explore the app for at least 15 minutes.
  • Take screenshots and attempt to crash the app.
@Daunt-99 Daunt-99 added the mi first steps - mobile virtual interns label Dec 19, 2024
@xyb994
Copy link
Member

xyb994 commented Dec 20, 2024

Go ahead with the change! I wonder if it's even better to move step 2 into its separate page as well 🤔

@Daunt-99
Copy link
Contributor Author

Yes absolutely that's a wonderful idea.

@MelonLord8
Copy link
Contributor

From what I could see on this issue and a few others, is that clarity/brevity is a present issue in this website, perhaps a page listing clear guidelines on how to write clear and concise instructions could be beneficial and a good idea for a new issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
mi first steps - mobile virtual interns
Projects
None yet
3 participants