matteo/malcontent
1
0
Fork 0
Code Issues Pull requests 2 Projects Releases Packages Wiki Activity

help: Add a basic user manual for malcontent-control

Browse source 
Signed-off-by: Philip Withnall <withnall@endlessm.com>
This commit is contained in:
Philip Withnall 2020-03-13 17:09:35 +00:00
parent 2591a20beb
commit b683ef7e37
11 changed files with 285 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

21
help/C/creating-a-child-user.page Normal file
View file

@ -0,0 +1,21 @@
<?xml version="1.0"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="creating-a-child-user">
<info>
<link type="guide" xref="index#setup"/>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Creating a child user on the computer.</desc>
</info>
<title>Creating a Child User</title>
<p>Parental controls can only be applied to non-administrator accounts. Such
an account may have been created when the computer was initially set up.
If not, a new child user may be created from the <app>Parental
Controls</app> application if no child users already exist; and otherwise
may be created from the <app>Control Center</app>.</p>
<p>To create a new child user, see <link type="guide" xref="help:gnome-help/user-add">Add a new user account</link>.
As soon as the new user is created, it will appear in the <app>Parental
Controls</app> window so that its parental controls settings can be
configured.</p>
</page>

21
help/C/index.page Normal file
View file

@ -0,0 +1,21 @@
<?xml version="1.0"?>
<page xmlns="http://projectmallard.org/1.0/" type="guide" id="index">
<info>
<revision pkgversion="0.7.0" version="0.1" date="2020-03-27" status="final"/>
<credit type="author copyright">
<name>Philip Withnall</name>
<email>withnall@endlessm.com</email>
<years>2020</years>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
<title>Parental Controls Help</title>
<section id="setup" style="2column">
<title>Introduction &amp; Setup</title>
</section>
<section id="controls" style="2column">
<title>Controls to Apply</title>
</section>
</page>

23
help/C/internet.page Normal file
View file

@ -0,0 +1,23 @@
<?xml version="1.0"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="internet">
<info>
<link type="guide" xref="index#controls"/>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Restricting a child user’s access to the internet.</desc>
</info>
<title>Restricting Access to the Internet</title>
<p>You can restrict a user’s access to the internet. This will prevent them
using a web browser, but it will not prevent them using the internet (in
potentially more limited forms) through other applications. For example,
it will not prevent access to e-mail accounts using <app>Evolution</app>,
and it will not prevent software updates being downloaded and applied.</p>
<p>To restrict a user’s access to the internet:</p>
<steps>
<item><p>Open the <app>Parental Controls</app> application.</p></item>
<item><p>Select the user in the tabs at the top.</p></item>
<item><p>Enable the <gui style="checkbox">Restrict Web Browsers</gui> checkbox.</p></item>
</steps>
</page>

28
help/C/introduction.page Normal file
View file

@ -0,0 +1,28 @@
<?xml version="1.0"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="introduction">
<info>
<link type="guide" xref="index#setup"/>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Overview of parental controls and the <app>Parental Controls</app> application.</desc>
<link type="seealso" xref="creating-a-child-user"/>
</info>
<title>Introduction to Parental Controls</title>
<p>Parental controls are a way to restrict what non-administrator accounts can
do on the computer, with the aim of allowing parents to restrict what their
children can do when using the computer unsupervised or under limited
supervision.</p>
<p>This functionality can be used in other situations ­– such as other
carer/caree relationships – but is labelled as ‘parental controls’ so that
it’s easy to find.</p>
<p>The parental controls for any user can be queried and set using the
<app>Parental Controls</app> application. This lists the non-administrator
accounts in tabs along its top bar, and shows their current parental
controls settings below. Changes to the parental controls apply immediately.</p>
<p>Restrictions on using the computer can only be applied to non-administrator
accounts. The parental controls settings for a user can only be changed by
an administrator, although the administrator can do so from the user’s
account by entering their password when prompted by the <app>Parental
Controls</app> application.</p>
</page>

6
help/C/legal.xml Normal file
View file

@ -0,0 +1,6 @@
<license xmlns="http://projectmallard.org/1.0/"
href="http://creativecommons.org/licenses/by-sa/3.0/">
<p>This work is licensed under a
<link href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons
Attribution-ShareAlike 3.0 Unported License</link>.</p>
</license>

30
help/C/restricting-applications.page Normal file
View file

@ -0,0 +1,30 @@
<?xml version="1.0"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="restricting-applications">
<info>
<link type="guide" xref="index#controls"/>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Restricting a child user from running already-installed applications.</desc>
</info>
<title>Restricting Access to Installed Applications</title>
<p>You can prevent a user from running specific applications which are already
installed on the computer. This could be useful if other users need those
applications but they are not appropriate for a child.</p>
<p>When installing additional software, you should consider whether that needs
to be restricted for some users — newly installed software is usable by all
users by default.</p>
<p>To restrict a user’s access to a specific application:</p>
<steps>
<item><p>Open the <app>Parental Controls</app> application.</p></item>
<item><p>Select the user in the tabs at the top.</p></item>
<item><p>Press the <gui style="button">Restrict Applications</gui> button.</p></item>
<item><p>Enable the switch in the row for each application you would like to restrict the user from accessing.</p></item>
<item><p>Close the <gui>Restrict Applications</gui> window.</p></item>
</steps>
<p>Restricting access to specific applications is often used in conjunction
with <link xref="software-installation"/> to prevent a user from installing
additional software which has not been vetted.</p>
</page>

76
help/C/software-installation.page Normal file
View file

@ -0,0 +1,76 @@
<?xml version="1.0"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="software-installation">
<info>
<link type="guide" xref="index#controls"/>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Restricting the software a child user can install, or preventing them installing additional software entirely.</desc>
</info>
<title>Restricting Software Installation</title>
<p>You can prevent a user from installing additional software, either for the
entire system, or just for themselves. They will still be able to search for
new software to install, but will need an administrator to authorize the
installation when they try to install an application.</p>
<p>Additionally, you can restrict which software a user can browse or search
for in the <app>Software</app> catalog by age categories.</p>
<p>To prevent a user from running an application which has already been
installed, see <link xref="restricting-applications"/>.</p>
<section id="installation">
<title>Preventing Software Installation</title>
<p>To prevent a user from installing additional software:</p>
<steps>
<item><p>Open the <app>Parental Controls</app> application.</p></item>
<item><p>Select the user in the tabs at the top.</p></item>
<item><p>Enable the <gui style="checkbox">Restrict Application Installation</gui> checkbox.</p></item>
<item><p>Or enable the <gui style="checkbox">Restrict Application Installation for Others</gui> checkbox.</p></item>
</steps>
<p>The <gui style="checkbox">Restrict Application Installation for Others</gui>
checkbox allows the user to install additional software for themselves, but
prevents that software from being made available to other users. It could be
used, for example, if there were two child users, one of whom is mature
enough to be allowed to install additional software, but the other isn’t —
enabling <gui style="checkbox">Restrict Application Installation for Others</gui>
would prevent the more mature child from installing applications which are
inappropriate for the other child and making them available to the other
child.</p>
</section>
<section id="oars">
<title>Restricting Software Installation by Age</title>
<p>Applications in the <app>Software</app> catalog have information about
content they contain which might be inappropriate for some ages — for
example, various forms of violence, unmoderated chat with other people on
the internet, or the possibility of spending money.</p>
<p>For each application, this information is summarized as the minimum age
child it is typically suitable to be used by — for example, “suitable for
ages 7+”. These age ratings are presented in region-specific schemes which
can be compared with the ratings schemes used for films and games.</p>
<p>The applications shown to a user in the <app>Software</app> catalog can
be filtered by their age suitability. Applications which are not suitable
for the user will be hidden, and will not be installable by that user.
They will be installable by other users (if their age suitability is set
high enough).</p>
<p>To filter the applications seen by a user in the <app>Software</app>
catalog to only those suitable for a certain age:</p>
<steps>
<item><p>Open the <app>Parental Controls</app> application.</p></item>
<item><p>Select the user in the tabs at the top.</p></item>
<item><p>In the <gui>Application Suitability</gui> list, select the age which applications should be suitable for.</p></item>
</steps>
<note style="important">
<p>The user’s actual age is not stored, so the <gui>Application Suitability</gui>
is not automatically updated over time as the child grows older. You
must periodically re-assess the appropriate <gui>Application Suitability</gui>
for each user.</p>
</note>
</section>
</page>

1
help/LINGUAS Normal file
View file

@ -0,0 +1 @@
# please keep this list sorted alphabetically

17
help/meson.build Normal file
View file

@ -0,0 +1,17 @@
help_media = [
]
help_files = [
'creating-a-child-user.page',
'index.page',
'internet.page',
'introduction.page',
'legal.xml',
'restricting-applications.page',
'software-installation.page',
]
gnome.yelp(meson.project_name(),
sources: help_files,
media: help_media,
symlink_media: true,
)