I just finished translating the MX 19 manual into Italian. While I was getting on with my work, I marked things that didn't seem right to me. This is the list.
They are almost always small imperfections, most of them are Links that no longer work
1) In 2.4.2 “The standard opening screen”, under Figure 2-5: “LiveMedium boot screen of x64 ISO”
it is written:
….Detailed Help on this screen can be found in this document.
The link doesn’t work
------------------------------------
2) Below just a hint:
In 2.5 The Installation process → 2.5.1 Detailed installation steps
under “Figure 2-15: SMART warning of risk of failure” →paragraph: “Auto-install using entire disk”
it is written:
If the Installer detects multiple partitions, the default option will be presented to allow you to select the partition into which you want to make the installation.
Yes, it is correct, but for a newbie it seems to me not clear enough, maybe might be better to write something like this:
Note. By default, the installer presents the choice "Automatic installation using the entire disk" if it detects a single partition, if it detects multiple partitions it will be presented as the default option: "Custom installation on existing partitions" to allow you to select the partition into which you want to make the installation.
-----------------------------
3) This is important:
In “2.6.4 Locking up” under “Figure 1-2: The MX and antiX bug manager”
section appears:
“1.6 Migration”
and then the sections:
“1.7 Our positions” and “1.8 Notes for Translators”
they're in the wrong place, they should be at the end of the first chapter
-----------------------------------------------------
4) In 3.2.3 ”Deprecated Tools”
should be:
3.2.24 Deprecated Tools
-------------------------------------------------------------------------------------------------
5) In 3.2.9 Live-usb Maker → HELP: here. ( under Figure 3-14: Live USB Maker)
the link doesn't work. The correct link is
https://mxlinux.org/wiki/help-files/hel ... usb-maker/
--------------------------------------
6) In 3.2.10 Menu Editor → the link to the video“MX Menu Editor”, doesn’t work.
The correct link is this:
https://www.youtube.com/watch?v=i84HR-Xss2Q
-------------------------
7) In 3.2.12 Nvidia driver installer → the link to “HELP: here”, under Figure 3-17, doesn’t work.
---------------------------
In 3.2.15 Sound Card → the link to HELP: here, under Figure 3-20, doesn’t work.
The correct link is:
https://mxlinux.org/wiki/help-files/help-mx-sound-card/
------------------------
9) In 3.3.2 Graphic drivers
it is written:
◦ Some Nvidia cards are no longer supported in Debian Stable (“Jessie”)
Jessie is old old stable. It should be:
◦ Some Nvidia cards are no longer supported in Debian Stable (“Buster”)
------
10) In 3.3.2 Graphic drivers
it is written:
Here are driver websites for the three most popular brands (do a web search on “<brandname> linux driver” for others):
◦ Nvidia
◦ Intel
They aren’t 3 popular brands, but 2
----------------------
11) Below just a hint:
In 3.3.4 Dual monitors
it is written:
Finer control of some features is sometimes available with xrandr.
Yes,but I realized that MX tweak, in MX 19, has added an extra tab:"Display" with a GUI for xrandr, so maybe you could fix it with something like that:
Finer control of some features is sometimes available with MX tweak, Display tab. Other useful tools in MX are arandr and lxrandr.
I also realized that the same problem is present here:
3.3.1 Resolution
Click Start Menu > Settings > Display. Use the pull-down menus to set the correct values for the monitor you want to adjust. For more options and finer control, install xrandr from the repos.
No need to install xrandr being present in MX tweak: it is installed by default.
so the sentence:
“For more options and finer control, install xrandr from the repos.”
might be corrected with something like this:
For more options and finer control, go to MX Tweak, display tab, or use the lxrandr or arandr tools
--------------------
12) Here I don’t report any errors but only my opinion:
I would join the paragraphs
3.4.3 Mobile Broadband and 3.4.4 Tethering
in one paragraph:
3.4.3 Mobile Broadband and Tethering
then divided into a first section:Mobile Broadband
and a second section: Tethering
so that the Troubleshooting section is better understood that it refers to both cases
------
13) In 4.8 Good practices -> 4.8.1 Backup -> List of installed program packages
it is written:
A list of programs you installed via the apt system will appear that you can copy and paste into a document for storage and reference.
You can create an inventory of all packages on your system installed since installation by copying this long command and running it in a terminal.
The link in "copying this long command" doesn’t work
---------------
14) In 4.8.2 Disk maintenance
under Figure 4-16
it is written:
After it had been cleaned using MX User Manager, the percentage dropped to about 63% and the sluggishness was gone.
In this sentence, MX User Manager should be replaced with MX Cleanup
-----------------
15) In 5.5.2 Deb packages -> Installing *.deb files with dpkg
2. Right-click an empty space to open a terminal and become root. Alternatively, click the arrow to move up one level and right-click the folder with the deb package > Open Thunar here.
deb package > Open Thunar here uhmm, that's not correct, you probably meant:
deb package > Open terminal here
---------------------------------
16) In 6.3 Alternate Window Managers
Budgie Desktop, a simple and elegant desktop using GTK+
the link Budgie Desktop doesn’t work
• KDE5 Standard, a very large and powerful environment adapted to the MX Linux environment. See the MX/antiX Wiki.
the link doesn’t work
-----------------------------------------
17) In 6.5.2 A useful script ->
Anyone who wanted to use such a script would have to carry out a few execution steps:
5. Change any names, locations, etc. to what they are on your particular system. In the example above, you may well have different names and/or locations for the directories to be backed up, and different devices where they are supposed to go.
I think it is better that point 5 is written like this:
5. Change any names, locations, etc. to what they are on your particular system. In the example above, you may well have different names and/or locations for the directories to be backed up, and different devices where they are supposed to go.
When you have corrected the script, also delete the numbers at the beginning of each line.
-----------------------
18) In 6.5.2 A useful script →Links
Directory of Linux Commands
the link doesn’t work
-------------------------
19) 6.5.4 Pre-installed user scripts
inxi
MORE: MX/antiX Wiki
the link doesn’t work
this should be correct:
https://mxlinux.org/wiki/applications/g ... gfxi-inxi/
---------------------------------------------
20) In 6.6.2 MX Live Usb maker
HELP: here.
the link doesn’t work
this should be correct:
https://mxlinux.org/wiki/help-files/hel ... usb-maker/
-----------------------
21) In 6.6.3 Live remaster/persistence (RemasterCC) -> Persistence
under Figure 6-8:
HELP: here
. the link doesn’t work
this should be correct:
https://mxlinux.org/wiki/help-files/help-mx-remaster/
--------------------------
22) In 6.6.4 Snapshot
under Figure 6-9:
HELP: here.
the link doesn’t work
-------------------------------------------
23) In 7.3 Permissions
CLI
....... To change this behavior, consult the MX/antiX Wiki.
the link doesn’t work
this should be correct:
https://mxlinux.org/wiki/system/format- ... ular-user/
----------------------------------------
24) In 7.3 Permissions → Links
File Permissions
the link doesn’t work, this should be correct:
https://www.linux.com/tutorials/underst ... rmissions/
------------------------------------------
25) In 7.6.6 Kernel panic and recovery -> Links
Ddrescue
the link doesn’t work
