Beta Manual feedback

Topics relating to MX Docs and MX Videos
Message
Author
User avatar
Jerry3904
Administrator
Posts: 23118
Joined: Wed Jul 19, 2006 6:13 am

Beta Manual feedback

#1 Post by Jerry3904 »

The beta version of the MX Linux Users Manual is now available off the Manuals tab at the top of the page. This thread is opened to collect feedback, corrections, suggestions, etc.

TIA
Production: 5.10, MX-23 Xfce, AMD FX-4130 Quad-Core, GeForce GT 630/PCIe/SSE2, 16 GB, SSD 120 GB, Data 1TB
Personal: Lenovo X1 Carbon with MX-23 Fluxbox
Other: Raspberry Pi 5 with MX-23 Xfce Raspberry Pi Respin

User avatar
megatotoro
Posts: 173
Joined: Wed Jun 09, 2010 5:59 pm

Re: Beta Manual feedback

#2 Post by megatotoro »

Impressive!

I think I found a typo.

On page 14, table 1, Home Persistence, line 3: "...but does not save system-wide settings are packages that have been installed."

It should read "system-wide settings and packages..."

User avatar
Gordon Cooper
Posts: 965
Joined: Mon Nov 21, 2011 4:50 pm

Re: Beta Manual feedback

#3 Post by Gordon Cooper »

Typo noted. Thanks Hawkeye!
Backup: Dell9010, MX-19_B2, Win7, 120 SSD, WD 232GIB HD, 4GB RAM
Primary :Homebrew64 bit Intel duo core 2 GB RAM, 120 GB Kingston SSD, Seagate1TB.
MX-18.2 64bit. Also MX17, Kubuntu14.04 & Puppy 6.3.

User avatar
kmathern
Developer
Posts: 2515
Joined: Wed Jul 12, 2006 2:26 pm

Re: Beta Manual feedback

#4 Post by kmathern »

Jerry3904 wrote: :bongodrums: :bongodrums: :bongodrums:
... As far as we know, all existing links to documentation have been corrected to point to it instead of the older MX Docs (which no longer exist except as transmogrified in the Manual) ...
These two need to be fixed:
http://www.mepiscommunity.org/user_manu ... html#check {needs to point to section 3.2.3}
http://www.mepiscommunity.org/user_manu ... tml#notify {needs to point to section 3.2.1}

User avatar
Paul..
Posts: 1786
Joined: Sun Mar 18, 2007 6:34 pm

Re: Beta Manual feedback

#5 Post by Paul.. »

2.1 Introduction

Last bullet
custom configuration may not work in a LiveDVD session...should be Live CD

Asus Prime X570-Pro | AMD Ryzen 7 3700X
16 Gig DDR4 3600 | Radeon RX 5600 XT Graphics
Samsung 860 500GB SSDs (2)

User avatar
Jerry3904
Administrator
Posts: 23118
Joined: Wed Jul 19, 2006 6:13 am

Re: Beta Manual feedback

#6 Post by Jerry3904 »

kmathern wrote:
Jerry3904 wrote: :bongodrums: :bongodrums: :bongodrums:
... As far as we know, all existing links to documentation have been corrected to point to it instead of the older MX Docs (which no longer exist except as transmogrified in the Manual) ...
These two need to be fixed:
http://www.mepiscommunity.org/user_manu ... html#check {needs to point to section 3.2.3}
http://www.mepiscommunity.org/user_manu ... tml#notify {needs to point to section 3.2.1}
They both do. Did you refresh the page?
Production: 5.10, MX-23 Xfce, AMD FX-4130 Quad-Core, GeForce GT 630/PCIe/SSE2, 16 GB, SSD 120 GB, Data 1TB
Personal: Lenovo X1 Carbon with MX-23 Fluxbox
Other: Raspberry Pi 5 with MX-23 Xfce Raspberry Pi Respin

User avatar
Paul..
Posts: 1786
Joined: Sun Mar 18, 2007 6:34 pm

Re: Beta Manual feedback

#7 Post by Paul.. »

2.1.1 PAE or non-PAE?

Make pae all-caps PAE

2nd paragraph + bullet
The method you use to determine whether you need the pae or non-pae version depends on the OS you currently run.
Linux. Open a terminal and enter this command (install inxi first if necessary): inxi -f. If the CPU Flags entry does not include pae in the list, then you’ll need the non-pae version.

Windows 2nd bullet
Windows®XP and Vista. Right click My Computer ≻ Properties, General tab. If it says Physical Address Extension (=PAE) at the bottom, then pae is the correct version to install.

2.2.1 Obtain the ISO

Last bullet before Fig 3
Transmission will then show the torrent in its list...should be Your torrent client

Asus Prime X570-Pro | AMD Ryzen 7 3700X
16 Gig DDR4 3600 | Radeon RX 5600 XT Graphics
Samsung 860 500GB SSDs (2)

User avatar
kmathern
Developer
Posts: 2515
Joined: Wed Jul 12, 2006 2:26 pm

Re: Beta Manual feedback

#8 Post by kmathern »

Jerry3904 wrote:They both do. Did you refresh the page?
Okay, they do now after doing a "Ctrl R".

User avatar
Paul..
Posts: 1786
Joined: Sun Mar 18, 2007 6:34 pm

Re: Beta Manual feedback

#9 Post by Paul.. »

2.2.3 Create the LiveMedium

1st Bullet
An ISO is a formatted image of an entire DVD. Should probably be formatted and bootable image of an OS.

2.3.1 Coming from Windows®

Accounts and passwords
I think maybe each of these bullets was meant to start with formatting like this?
  • ISP login information. You will need at least your...
To be consistent, use same formatting for the bullets in previous section? Backing up email, calendar, and contact data and the next section? Browser favorites

General comment on the use of Windows® or other trademarks. You only need to use the trademark symbol ® once in a document, the first time it is used is sufficient. No need to repeat it throughout the whole document.

2.4.2 The opening screen

Last line with link before section 2.4.3
MORE: Liinux startup process...should be Linux startup process

Asus Prime X570-Pro | AMD Ryzen 7 3700X
16 Gig DDR4 3600 | Radeon RX 5600 XT Graphics
Samsung 860 500GB SSDs (2)

User avatar
Adrian
Developer
Posts: 8904
Joined: Wed Jul 12, 2006 1:42 am

Re: Beta Manual feedback

#10 Post by Adrian »

2.5.1 Detailed installation steps
Somewhere there it should be mentioned that it's a good idea to update mx-installer from before installing MX, for example the feature to "save live desktop changes" that is referenced in the manual is not available in the installer that comes on the CD, but it's available in the repos (actually, Tim will update the package in the repo and it will become available very soon).

Also, not sure if it's worth taking another screenshot, but the Installer Screen 2 now has two checkboxes for setting disk labels (if people don't want to go with the default).

Locked

Return to “Documentation and videos”