Skip to content

Commit

Permalink
Rename FAQ Strings (#5347)
Browse files Browse the repository at this point in the history 
## Explanation
Renamed FAQ question and answer strings from index-based to more
descriptive qualifiers.
The corresponding translations to the previous strings have been
deleted.
The goal is to to overwrite existing faq strings and re-translate them,
since a number of updates were made in #5246 and #5332.


[device-2024-02-22-030542.webm](https://github.com/oppia/oppia-android/assets/59600948/be9a7cc8-89eb-4a1f-a02f-1466ffb0092f)

## Essential Checklist
<!-- Please tick the relevant boxes by putting an "x" in them. -->
- [ ] The PR title and explanation each start with "Fix #bugnum: " (If
this PR fixes part of an issue, prefix the title with "Fix part of
#bugnum: ...".)
- [ ] Any changes to
[scripts/assets](https://github.com/oppia/oppia-android/tree/develop/scripts/assets)
files have their rationale included in the PR explanation.
- [x] The PR follows the [style
guide](https://github.com/oppia/oppia-android/wiki/Coding-style-guide).
- [x] The PR does not contain any unnecessary code changes from Android
Studio
([reference](https://github.com/oppia/oppia-android/wiki/Guidance-on-submitting-a-PR#undo-unnecessary-changes)).
- [x] The PR is made from a branch that's **not** called "develop" and
is up-to-date with "develop".
- [x] The PR is **assigned** to the appropriate reviewers
([reference](https://github.com/oppia/oppia-android/wiki/Guidance-on-submitting-a-PR#clarification-regarding-assignees-and-reviewers-section)).

## For UI-specific PRs only
<!-- Delete these section if this PR does not include UI-related
changes. -->
If your PR includes UI-related changes, then:
- Add screenshots for portrait/landscape for both a tablet & phone of
the before & after UI changes
- For the screenshots above, include both English and pseudo-localized
(RTL) screenshots (see [RTL
guide](https://github.com/oppia/oppia-android/wiki/RTL-Guidelines))
- Add a video showing the full UX flow with a screen reader enabled (see
[accessibility
guide](https://github.com/oppia/oppia-android/wiki/Accessibility-A11y-Guide))
- For PRs introducing new UI elements or color changes, both light and
dark mode screenshots must be included
- Add a screenshot demonstrating that you ran affected Espresso tests
locally & that they're passing

---------

Co-authored-by: Ben Henning <ben@oppia.org>
  • Loading branch information
@adhiamboperes @BenHenning
adhiamboperes and BenHenning authored Mar 1, 2024
1 parent 0bc5e43 commit 0911e71
Show file tree
Hide file tree
Showing 8 changed files with 141 additions and 164 deletions.
40 changes: 14 additions & 26 deletions app/src/main/res/values-ar/strings.xml
View file

Large diffs are not rendered by default.

52 changes: 26 additions & 26 deletions app/src/main/res/values-pcm-rNG/strings.xml
View file

Large diffs are not rendered by default.

40 changes: 14 additions & 26 deletions app/src/main/res/values-pt-rBR/strings.xml
View file

Large diffs are not rendered by default.

52 changes: 26 additions & 26 deletions app/src/main/res/values-sw/strings.xml
View file

Large diffs are not rendered by default.

50 changes: 26 additions & 24 deletions app/src/main/res/values/faqs.xml
View file
Original file line number Diff line number Diff line change
@@ -1,32 +1,34 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string-array name="faq_questions">
<item>@string/faq_question_1</item>
<item>@string/faq_question_2</item>
<item>@string/faq_question_3</item>
<item>@string/faq_question_4</item>
<item>@string/faq_question_5</item>
<item>@string/faq_question_6</item>
<item>@string/faq_question_7</item>
<item>@string/faq_question_9</item>
<item>@string/faq_question_10</item>
<item>@string/faq_question_11</item>
<item>@string/faq_question_12</item>
<item>@string/faq_question_13</item>
<item>@string/faq_question_whats_oppia</item>
<item>@string/faq_question_whos_an_admin</item>
<item>@string/faq_question_create_profile</item>
<item>@string/faq_question_app_language</item>
<item>@string/faq_question_bug_reporting</item>
<item>@string/faq_question_math_lessons</item>
<item>@string/faq_question_more_lessons</item>
<item>@string/faq_question_exploration_player</item>
<item>@string/faq_question_audio_not_playing</item>
<item>@string/faq_question_delete_profile</item>
<item>@string/faq_question_update_app</item>
<item>@string/faq_question_update_os</item>
<item>@string/faq_question_cant_find_question</item>
</string-array>

<string-array name="faq_answers">
<item>@string/faq_answer_1</item>
<item>@string/faq_answer_2</item>
<item>@string/faq_answer_3</item>
<item>@string/faq_answer_4</item>
<item>@string/faq_answer_5</item>
<item>@string/faq_answer_6</item>
<item>@string/faq_answer_7</item>
<item>@string/faq_answer_9</item>
<item>@string/faq_answer_10</item>
<item>@string/faq_answer_11</item>
<item>@string/faq_answer_12</item>
<item>@string/faq_answer_13</item>
<item>@string/faq_answer_whats_oppia</item>
<item>@string/faq_answer_whos_an_admin</item>
<item>@string/faq_answer_create_profile</item>
<item>@string/faq_answer_app_language</item>
<item>@string/faq_answer_bug_reporting</item>
<item>@string/faq_answer_math_lessons</item>
<item>@string/faq_answer_more_lessons</item>
<item>@string/faq_answer_exploration_player</item>
<item>@string/faq_answer_audio_not_playing</item>
<item>@string/faq_answer_delete_profile</item>
<item>@string/faq_answer_update_app</item>
<item>@string/faq_answer_update_os</item>
<item>@string/faq_answer_cant_find_question</item>
</string-array>
</resources>
53 changes: 26 additions & 27 deletions app/src/main/res/values/strings.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -547,34 +547,33 @@
<string name="agree_to_terms"><![CDATA[By using %s, you agree to our <br> <oppia-noninteractive-policy link="tos">Terms of Service</oppia-noninteractive-policy> and <oppia-noninteractive-policy link="privacy">Privacy Policy</oppia-noninteractive-policy>.]]></string>
<string name="terms_of_service_web_link"><![CDATA[Please visit <a href="https://www.oppia.org/terms">this page</a> for the latest version of these terms.]]></string>
<!-- Frequently asked questions & generic app help. -->
<string name="faq_question_whats_oppia">What is %s?</string>
<string name="faq_question_whos_an_admin">Who is an Administrator?</string>
<string name="faq_question_create_profile">How can I create a new profile?</string>
<string name="faq_question_app_language">How do I get the app in my language?</string>
<string name="faq_question_bug_reporting">I found a bug. How can I report it?</string>
<string name="faq_question_math_lessons">Why are there only math lessons?</string>
<string name="faq_question_more_lessons">Will you be making more lessons?</string>
<string name="faq_question_exploration_player">Why is the Exploration player not loading?</string>
<string name="faq_question_audio_not_playing">Why is my audio not playing?</string>
<string name="faq_question_delete_profile">How can I delete a profile?</string>
<string name="faq_question_update_app">How do I update the app?</string>
<string name="faq_question_update_os">How do I update my Android OS?</string>
<string name="faq_question_cant_find_question">I can\'t find my question here. What now?</string>

<string name="faq_question_1">What is %s?</string>
<string name="faq_question_2">Who is an Administrator?</string>
<string name="faq_question_3">How can I create a new profile?</string>
<string name="faq_question_4">How do I get the app in my language?</string>
<string name="faq_question_5">I found a bug. How can I report it?</string>
<string name="faq_question_6">Why are there only math lessons?</string>
<string name="faq_question_7">Will you be making more lessons?</string>
<string name="faq_question_8">Why is the Exploration player not loading?</string>
<string name="faq_question_9">Why is my audio not playing?</string>
<string name="faq_question_10">How can I delete a profile?</string>
<string name="faq_question_11">How do I update the app?</string>
<string name="faq_question_12">How do I update my Android OS?</string>
<string name="faq_question_13">I can\'t find my question here. What now?</string>

<string name="faq_answer_1"><![CDATA[<p>%1$s <i>"O-pee-yah"</i> (Finnish) - "to learn"</p><p><br></p><p>%1$s\'s mission is to help anyone learn anything they want in an effective and enjoyable way.</p><p><br></p><p>By creating a set of free, high-quality, demonstrably effective lessons with the help of educators from around the world, %1$s aims to provide students with quality education — regardless of where they are or what traditional resources they have access to.</p><p><br></p><p>As a student, you can begin your learning adventure by browsing the topics listed on the Home Page!</p>]]></string>
<string name="faq_answer_2"><![CDATA[<p>An Administrator is the main user that manages profiles and settings for every profile on their account. They are most likely your parent, teacher, or guardian that created this profile for you. </p><p><br></p><p>Administrators have the ability to manage profiles, assign PINs, and change other settings under their account. Depending on your profile, Administrator permissions may be required for certain features such as changing your PIN, and more. </p><p><br></p><p>To see who your Administrator is, go to the Profile Chooser. The first profile listed and has "Administrator" written under their name is the Administrator. </p>]]></string>
<string name="faq_answer_3"><![CDATA[<p>If it is your first time creating a profile and you do not have a PIN:<ol><li>From the Profile Chooser, tap on <strong>Set up Multiple Profiles</strong>.</li><li>Create a PIN and <strong>Save</strong>.</li><li>Fill in all fields for the profile.<ol><li>(Optional) Upload a photo.</li><li>Enter a name.</li><li>(Optional) Assign a 3-digit PIN.</li></ol></li><li>Tap <strong>Create</strong>. This profile is added to your Profile Chooser!</li></ol></p><p> If you have created a profile before and have a PIN:<ol><li>From the Profile Chooser, tap on <strong>Add Profile</strong>. </li><li>Enter your PIN and tap <strong>Submit</strong>. </li><li>Fill in all fields for the profile.<ol><li> (Optional) Upload a photo. </li><li> Enter a name. </li><li> (Optional) Assign a 3-digit PIN. </li></ol></li><li>Tap <strong>Create</strong>. This profile is added to your Profile Chooser!</li></ol></p><br><p>Note: Only the <u>Administrator</u> is able to manage profiles.</p>]]></string>
<string name="faq_answer_4"><![CDATA[<p>The %s app currently supports English, Brazilian Portuguese, Arabic, Swahili and Nigerian Pidgin. Choose one of these languages in the menu, under Options. To request the app in your language, please contact us at <strong>admin@oppia.org<strong>.</p>]]></string>
<string name="faq_answer_5"><![CDATA[<p><ol><li>From your %s app home screen, tap the menu in the top left corner.</li><li>Tap <strong>Share feedback</strong>.</li><li>Follow the instructions to report the bug or share feedback.</li></p>]]></string>
<string name="faq_answer_6"><![CDATA[<p>%1$s’s mission is to help learners gain necessary life skills. Math is an essential skill in everyday life. %1$s will be offering new lessons on science and other subjects soon!</p>]]></string>
<string name="faq_answer_7"><![CDATA[<p>Yes, %s will be offering new lessons on science and other subjects soon. Please check back for updates!</p>]]></string>
<string name="faq_answer_8"><![CDATA[<p>If the Exploration Player is not loading</p><p><br></p><p>Check to see if the app is up to date:</p><p><ul><li> Go to the Play Store and make sure the app is updated to its latest version </li></ul><p><br></p><p>Check your internet connection:</p><ul><li> If your internet connection is slow, try re-connecting to your Wi-Fi network or connecting to a different network. </li></ul><p>Ask the Administrator to check their device and internet connection:</p><ul><li> Get the Administrator to troubleshoot using the steps above </li></ul><p>Let us know if you still have issues with loading:</p><ul><li> Report a problem by contacting us at admin@oppia.org. </li></ul>]]></string>
<string name="faq_answer_9"><![CDATA[<p>If your audio is not playing</p><p><br></p><p>Check to see if the app is up to date:</p><ul><li> Go to the Play Store and make sure the app is updated to its latest version </li></ul><p><br></p><p>Check your internet connection:</p><ul><li> If your internet connection is slow, try re-connecting to your Wi-Fi network or connecting to a different network. Slow internet may cause the audio to load irregularly, making it difficult to play. </li></ul><p><br></p><p>Ask the Administrator to check their device and internet connection:</p><ul><li> Get the Administrator to troubleshoot using the steps above</li></ul><p><br></p><p>Let us know if you still have issues with loading:</p><ul><li> Report a problem by contacting us at admin@oppia.org. </li></ul>]]></string>
<string name="faq_answer_10"><![CDATA[<p>Once a profile is deleted:</p><ol><li>The profile cannot be recovered. </li><li> Profile information such as name, photos, and progress will be permanently deleted. </li></ol><p>To delete a profile (excluding the <u>Administrator\'s</u>):</p><ol><li> From the Administrator\'s Home Page, tap on the menu button on the top left. </li><li>Tap on <strong>Administrator Controls</strong>. </li><li>Tap on <strong>Edit Profiles</strong>. </li><li>Tap on the Profile you would like to delete. </li><li>At the bottom of the screen, tap <strong>Profile Deletion</strong>. </li><li>Tap <strong>Delete</strong> to confirm deletion. </li></ol><p><br></p><p>Note: Only the <u>Administrator</u> is able to manage profiles.</p>]]></string>
<string name="faq_answer_11"><![CDATA[<p><ol><li>Open the Google Play Store app.</li><li>Search for the %s app.</li><li>Tap Update.</p>]]></string>
<string name="faq_answer_12"><![CDATA[<p><ol><li>Tap your phone\'s Settings app.</li><li>Tap System updates.</li><li>Tap System updates and follow the instructions to update your Android operating system.</p>]]></string>
<string name="faq_answer_13"><![CDATA[<p>If you cannot find your question or would like to report a bug, contact us at <strong>admin@oppia.org.</strong></p>]]></string>
<string name="faq_answer_whats_oppia"><![CDATA[<p>%1$s <i>"O-pee-yah"</i> (Finnish) - "to learn"</p><p><br></p><p>%1$s\'s mission is to help anyone learn anything they want in an effective and enjoyable way.</p><p><br></p><p>By creating a set of free, high-quality, demonstrably effective lessons with the help of educators from around the world, %1$s aims to provide students with quality education — regardless of where they are or what traditional resources they have access to.</p><p><br></p><p>As a student, you can begin your learning adventure by browsing the topics listed on the Home Page!</p>]]></string>
<string name="faq_answer_whos_an_admin"><![CDATA[<p>An Administrator is the main user that manages profiles and settings for every profile on their account. They are most likely your parent, teacher, or guardian that created this profile for you. </p><p><br></p><p>Administrators have the ability to manage profiles, assign PINs, and change other settings under their account. Depending on your profile, Administrator permissions may be required for certain features such as changing your PIN, and more. </p><p><br></p><p>To see who your Administrator is, go to the Profile Chooser. The first profile listed and has "Administrator" written under their name is the Administrator. </p>]]></string>
<string name="faq_answer_create_profile"><![CDATA[<p>If it is your first time creating a profile and you do not have a PIN:<ol><li>From the Profile Chooser, tap on <strong>Set up Multiple Profiles</strong>.</li><li>Create a PIN and <strong>Save</strong>.</li><li>Fill in all fields for the profile.<ol><li>(Optional) Upload a photo.</li><li>Enter a name.</li><li>(Optional) Assign a 3-digit PIN.</li></ol></li><li>Tap <strong>Create</strong>. This profile is added to your Profile Chooser!</li></ol></p><p> If you have created a profile before and have a PIN:<ol><li>From the Profile Chooser, tap on <strong>Add Profile</strong>. </li><li>Enter your PIN and tap <strong>Submit</strong>. </li><li>Fill in all fields for the profile.<ol><li> (Optional) Upload a photo. </li><li> Enter a name. </li><li> (Optional) Assign a 3-digit PIN. </li></ol></li><li>Tap <strong>Create</strong>. This profile is added to your Profile Chooser!</li></ol></p><br><p>Note: Only the <u>Administrator</u> is able to manage profiles.</p>]]></string>
<string name="faq_answer_app_language"><![CDATA[<p>The %s app currently supports English, Brazilian Portuguese, Arabic, Swahili and Nigerian Pidgin. Choose one of these languages in the menu, under Options. To request the app in your language, please contact us at <strong>admin@oppia.org<strong>.</p>]]></string>
<string name="faq_answer_bug_reporting"><![CDATA[<p><ol><li>From your %s app home screen, tap the menu in the top left corner.</li><li>Tap <strong>Share feedback</strong>.</li><li>Follow the instructions to report the bug or share feedback.</li></p>]]></string>
<string name="faq_answer_math_lessons"><![CDATA[<p>%1$s’s mission is to help learners gain necessary life skills. Math is an essential skill in everyday life. %1$s will be offering new lessons on science and other subjects soon!</p>]]></string>
<string name="faq_answer_more_lessons"><![CDATA[<p>Yes, %s will be offering new lessons on science and other subjects soon. Please check back for updates!</p>]]></string>
<string name="faq_answer_exploration_player"><![CDATA[<p>If the Exploration Player is not loading</p><p><br></p><p>Check to see if the app is up to date:</p><p><ul><li> Go to the Play Store and make sure the app is updated to its latest version </li></ul><p><br></p><p>Check your internet connection:</p><ul><li> If your internet connection is slow, try re-connecting to your Wi-Fi network or connecting to a different network. </li></ul><p>Ask the Administrator to check their device and internet connection:</p><ul><li> Get the Administrator to troubleshoot using the steps above </li></ul><p>Let us know if you still have issues with loading:</p><ul><li> Report a problem by contacting us at admin@oppia.org. </li></ul>]]></string>
<string name="faq_answer_audio_not_playing"><![CDATA[<p>If your audio is not playing</p><p><br></p><p>Check to see if the app is up to date:</p><ul><li> Go to the Play Store and make sure the app is updated to its latest version </li></ul><p><br></p><p>Check your internet connection:</p><ul><li> If your internet connection is slow, try re-connecting to your Wi-Fi network or connecting to a different network. Slow internet may cause the audio to load irregularly, making it difficult to play. </li></ul><p><br></p><p>Ask the Administrator to check their device and internet connection:</p><ul><li> Get the Administrator to troubleshoot using the steps above</li></ul><p><br></p><p>Let us know if you still have issues with loading:</p><ul><li> Report a problem by contacting us at admin@oppia.org. </li></ul>]]></string>
<string name="faq_answer_delete_profile"><![CDATA[<p>Once a profile is deleted:</p><ol><li>The profile cannot be recovered. </li><li> Profile information such as name, photos, and progress will be permanently deleted. </li></ol><p>To delete a profile (excluding the <u>Administrator\'s</u>):</p><ol><li> From the Administrator\'s Home Page, tap on the menu button on the top left. </li><li>Tap on <strong>Administrator Controls</strong>. </li><li>Tap on <strong>Edit Profiles</strong>. </li><li>Tap on the Profile you would like to delete. </li><li>At the bottom of the screen, tap <strong>Profile Deletion</strong>. </li><li>Tap <strong>Delete</strong> to confirm deletion. </li></ol><p><br></p><p>Note: Only the <u>Administrator</u> is able to manage profiles.</p>]]></string>
<string name="faq_answer_update_app"><![CDATA[<p><ol><li>Open the Google Play Store app.</li><li>Search for the %s app.</li><li>Tap Update.</p>]]></string>
<string name="faq_answer_update_os"><![CDATA[<p><ol><li>Tap your phone\'s Settings app.</li><li>Tap System updates.</li><li>Tap System updates and follow the instructions to update your Android operating system.</p>]]></string>
<string name="faq_answer_cant_find_question"><![CDATA[<p>If you cannot find your question or would like to report a bug, contact us at <strong>admin@oppia.org.</strong></p>]]></string>

<string name="profile_edit_fragment_test_activity_label">Profile Edit Fragment Test Activity</string>
<string name="administrator_controls_fragment_test_activity_label">Administrator Controls Fragment Test Activity</string>
Expand Down
12 changes: 6 additions & 6 deletions app/src/sharedTest/java/org/oppia/android/app/faq/FAQListFragmentTest.kt
View file
Original file line number Diff line number Diff line change
Expand Up @@ -154,11 +154,11 @@ class FAQListFragmentTest {
allOf(
hasExtra(
FAQSingleActivity.FAQ_SINGLE_ACTIVITY_QUESTION,
getResources().getString(R.string.faq_question_3)
getResources().getString(R.string.faq_question_create_profile)
),
hasExtra(
FAQSingleActivity.FAQ_SINGLE_ACTIVITY_ANSWER,
getResources().getString(R.string.faq_answer_3)
getResources().getString(R.string.faq_answer_create_profile)
),
hasComponent(FAQSingleActivity::class.java.name)
)
Expand All @@ -180,11 +180,11 @@ class FAQListFragmentTest {
allOf(
hasExtra(
FAQSingleActivity.FAQ_SINGLE_ACTIVITY_QUESTION,
getResources().getString(R.string.faq_question_3)
getResources().getString(R.string.faq_question_create_profile)
),
hasExtra(
FAQSingleActivity.FAQ_SINGLE_ACTIVITY_ANSWER,
getResources().getString(R.string.faq_answer_3)
getResources().getString(R.string.faq_answer_create_profile)
),
hasComponent(FAQSingleActivity::class.java.name)
)
Expand All @@ -205,11 +205,11 @@ class FAQListFragmentTest {
allOf(
hasExtra(
FAQSingleActivity.FAQ_SINGLE_ACTIVITY_QUESTION,
getResources().getString(R.string.faq_question_1, getAppName())
getResources().getString(R.string.faq_question_whats_oppia, getAppName())
),
hasExtra(
FAQSingleActivity.FAQ_SINGLE_ACTIVITY_ANSWER,
getResources().getString(R.string.faq_answer_1, getAppName())
getResources().getString(R.string.faq_answer_whats_oppia, getAppName())
),
hasComponent(FAQSingleActivity::class.java.name)
)
Expand Down
Loading

0 comments on commit 0911e71

Please sign in to comment.