[documentation/gcompris-teachers-handbook] doc: docs, improve alt image by using real sentences
Johnny Jazeix
null at kde.org
Mon Mar 30 13:19:36 BST 2026
Git commit 94ad0e055a5efb8104c456435355b8f0d1dbc814 by Johnny Jazeix, on behalf of Suryansh NA.
Committed on 30/03/2026 at 12:19.
Pushed by jjazeix into branch 'master'.
docs, improve alt image by using real sentences
M +34 -34 doc/index.docbook
https://invent.kde.org/documentation/gcompris-teachers-handbook/-/commit/94ad0e055a5efb8104c456435355b8f0d1dbc814
diff --git a/doc/index.docbook b/doc/index.docbook
index a66fcea..1ac2e24 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -112,7 +112,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="main_screen.png" />
</imageobject>
<textobject>
- <phrase>main_screen</phrase>
+ <phrase>The GCompris Teachers main screen showing the dashboard and login interface.</phrase>
</textobject>
</mediaobject>
</para>
@@ -124,7 +124,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="main_screen_hamburger.png" />
</imageobject>
<textobject>
- <phrase>main_screen_hamburger</phrase>
+ <phrase>A view of the sidebar menu with the hamburger icon used to expand or collapse the labels.</phrase>
</textobject>
</mediaobject>
</para>
@@ -140,7 +140,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="main_screen_create_db.png" />
</imageobject>
<textobject>
- <phrase>main_screen_create_db</phrase>
+ <phrase>The dialog for creating a new teacher account with a username and password and choosing database encryption settings.</phrase>
</textobject>
</mediaobject>
</para>
@@ -154,7 +154,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="pupils_groups.png" />
</imageobject>
<textobject>
- <phrase>pupils_groups</phrase>
+ <phrase>The management screen where a teacher can view the list of groups and pupils.</phrase>
</textobject>
</mediaobject>
</para>
@@ -169,7 +169,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="group_add.png" />
</imageobject>
<textobject>
- <phrase>group_add</phrase>
+ <phrase>The dialog box to add a new pupil group by entering its name and description.</phrase>
</textobject>
</mediaobject>
</para>
@@ -185,7 +185,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="group_delete_button.png" />
</imageobject>
<textobject>
- <phrase>group_delete_button</phrase>
+ <phrase>The interface showing how edit and delete buttons appear when hovering over a group name.</phrase>
</textobject>
</mediaobject>
</para>
@@ -199,7 +199,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="group_delete_confirmation.png" />
</imageobject>
<textobject>
- <phrase>group_delete_confirmation</phrase>
+ <phrase>The confirmation prompt asking the teacher if they are sure they want to delete a group.</phrase>
</textobject>
</mediaobject>
</para>
@@ -215,7 +215,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="pupil_create.png" />
</imageobject>
<textobject>
- <phrase>pupil_create</phrase>
+ <phrase>The 'Add a pupil' window showing fields for pupil name, password, and group selection.</phrase>
</textobject>
</mediaobject>
</para>
@@ -230,7 +230,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="pupil_import.png" />
</imageobject>
<textobject>
- <phrase>pupil_import</phrase>
+ <phrase>The import interface used to upload multiple pupil profiles from a CSV file.</phrase>
</textobject>
</mediaobject>
</para>
@@ -254,14 +254,14 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="pupil_add_to_group.png" />
</imageobject>
<textobject>
- <phrase>pupil_add_to_group</phrase>
+ <phrase>The interface showing the buttons used to assign a specific pupil to a classroom group.</phrase>
</textobject>
</mediaobject> <mediaobject>
<imageobject>
<imagedata fileref="pupil_remove_from_group.png" />
</imageobject>
<textobject>
- <phrase>pupil_remove_from_group</phrase>
+ <phrase>The interface showing how to remove a pupil from their currently assigned group.</phrase>
</textobject>
</mediaobject>
</para>
@@ -272,7 +272,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="pupil_delete.png" />
</imageobject>
<textobject>
- <phrase>pupil_delete</phrase>
+ <phrase>The pupil management screen highlighting the delete button for pupil accounts.</phrase>
</textobject>
</mediaobject>
</para>
@@ -291,7 +291,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="connect_devices.png" />
</imageobject>
<textobject>
- <phrase>connect_devices</phrase>
+ <phrase>The 'Connect devices' dashboard displaying the status of all available pupils and groups.</phrase>
</textobject>
</mediaobject>
</para>
@@ -308,7 +308,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="settings.png" />
</imageobject>
<textobject>
- <phrase>settings</phrase>
+ <phrase>The settings page where the Server ID and Port number are configured for network communication.</phrase>
</textobject>
</mediaobject>
</para>
@@ -320,7 +320,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="gcompris_teacher_config_button.png" />
</imageobject>
<textobject>
- <phrase>gcompris_teacher_config_button</phrase>
+ <phrase>A confirmation dialog on the pupil's device asking to connect to the teacher's server.</phrase>
</textobject>
</mediaobject>
</para>
@@ -331,7 +331,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="gcompris_teacher_settings.png" />
</imageobject>
<textobject>
- <phrase>gcompris_teacher_settings</phrase>
+ <phrase>The client-side settings screen where pupils enter the matching Server ID and Port.</phrase>
</textobject>
</mediaobject>
</para>
@@ -354,7 +354,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="gcompris_connect.png" />
</imageobject>
<textobject>
- <phrase>gcompris_connect</phrase>
+ <phrase>A pop-up on the pupil's device asking for permission to connect to the teacher's server.</phrase>
</textobject>
</mediaobject>
<itemizedlist>
@@ -369,7 +369,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="gcompris_select_login.png" />
</imageobject>
<textobject>
- <phrase>gcompris_select_login</phrase>
+ <phrase>The login selection screen on the pupil device showing the list of names sent by the teacher.</phrase>
</textobject>
</mediaobject>
</para></listitem>
@@ -379,7 +379,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="gcompris_password.png" />
</imageobject>
<textobject>
- <phrase>gcompris_password</phrase>
+ <phrase>The password entry dialog on the pupil device for logging into their specific profile.</phrase>
</textobject>
</mediaobject>
</para></listitem>
@@ -390,7 +390,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="gcompris_connect_ok.png" />
</imageobject>
<textobject>
- <phrase>gcompris_connect_ok</phrase>
+ <phrase>The GCompris navigation bar showing a green indicator for a successful server connection.</phrase>
</textobject>
</mediaobject>
</para></listitem>
@@ -400,7 +400,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="connect_devices_password_correct_incorrect.png" />
</imageobject>
<textobject>
- <phrase>connect_devices_password_correct_incorrect</phrase>
+ <phrase>The teacher's dashboard showing color-coded status indicators for successful and failed login attempts.</phrase>
</textobject>
</mediaobject>
</para></listitem>
@@ -420,7 +420,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="connect_devices_password_disconnected_not_connected.png" />
</imageobject>
<textobject>
- <phrase>connect_devices_password_disconnected_not_connected</phrase>
+ <phrase>The connection list displaying different colors for disconnected pupils versus those who haven't yet connected.</phrase>
</textobject>
</mediaobject>
</para>
@@ -435,7 +435,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="activities.png" />
</imageobject>
<textobject>
- <phrase>activities</phrase>
+ <phrase>The activities results page showing filters for date, group, and specific educational tasks.</phrase>
</textobject>
</mediaobject>
</para>
@@ -448,7 +448,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="activities_results.png" />
</imageobject>
<textobject>
- <phrase>activities_results</phrase>
+ <phrase>A detailed breakdown of pupil performance in the 'vertical subtraction' activity, showing errors and successes.</phrase>
</textobject>
</mediaobject>
</para>
@@ -468,7 +468,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="datasets.png" />
</imageobject>
<textobject>
- <phrase>datasets</phrase>
+ <phrase>The dataset management page where teachers create custom content for various activities.</phrase>
</textobject>
</mediaobject>
</para>
@@ -489,7 +489,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="dataset_create_update.png" />
</imageobject>
<textobject>
- <phrase>dataset_create_update</phrase>
+ <phrase>The activity editor for 'Binary bulbs' activity, allowing customization of dataset names and difficulty levels.</phrase>
</textobject>
</mediaobject>
</para>
@@ -501,7 +501,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="dataset_instructions.png" />
</imageobject>
<textobject>
- <phrase>dataset_instructions</phrase>
+ <phrase>The instructions panel providing guidance on how to correctly fill out custom activity data.</phrase>
</textobject>
</mediaobject>
</para>
@@ -513,7 +513,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="dataset_delete.png" />
</imageobject>
<textobject>
- <phrase>dataset_delete</phrase>
+ <phrase>The confirmation prompt used to safely delete a custom dataset from the teacher tool.</phrase>
</textobject>
</mediaobject>
</para>
@@ -527,7 +527,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="dataset_send_client.png" />
</imageobject>
<textobject>
- <phrase>dataset_send_client</phrase>
+ <phrase>The interface for selecting which connected pupil devices should receive a new dataset.</phrase>
</textobject>
</mediaobject>
</para>
@@ -542,7 +542,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="gcompris_multiple-choice_questions.png" />
</imageobject>
<textobject>
- <phrase>gcompris_multiple-choice_questions</phrase>
+ <phrase>The preview of the 'Multiple choice questions' activity on the pupil device.</phrase>
</textobject>
</mediaobject>
</para>
@@ -558,7 +558,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="charts.png" />
</imageobject>
<textobject>
- <phrase>charts</phrase>
+ <phrase>The charts overview page providing a graphical visualization of pupil and group progress.</phrase>
</textobject>
</mediaobject>
</para>
@@ -573,7 +573,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="charts_view_results_pupil.png" />
</imageobject>
<textobject>
- <phrase>charts_view_results_pupil</phrase>
+ <phrase>A graphical view showing the success rate and history for a specific pupil.</phrase>
</textobject>
</mediaobject>
</para>
@@ -585,7 +585,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="charts_view_results_activity.png" />
</imageobject>
<textobject>
- <phrase>charts_view_results_activity</phrase>
+ <phrase>A chart displaying the overall class performance for a single selected activity.</phrase>
</textobject>
</mediaobject>
</para>
@@ -600,7 +600,7 @@ GCompris is a multi-activity educational software. This documentation is for the
<imagedata fileref="settings.png" />
</imageobject>
<textobject>
- <phrase>settings</phrase>
+ <phrase>The general settings page showing information about the current session.</phrase>
</textobject>
</mediaobject>
</para>
More information about the kde-doc-english
mailing list