Hi Michael,

Thanks for your thoughtful and detailed comments. Response inline below.

On 2019-01-01 09:46, Michael wrote:
On Tuesday 01 January 2019 03:46:52 am goli...@dyne.org wrote:
tweaking the install guides and adding one for the desktop-live gui
install. You can start here:

https://beta.devuan.org/os/documentation/install-guides/start-here.html


Hi golinux,

These thoughts are from the angle of helping someone who’s never done an install of any OS before. My guess is most people haven’t, as when buying a
new computer the OS is almost always already installed now days.

I’ve added stubs where I can, but do edit for better user clarity!

# # #


# # Sections to Add:

= Which Release version is right for me?

Explain when/why they should choose ASCII or Jessie.

= {Explanation of the .iso naming scheme}

devuan_ascii_2.0.0_amd64_netinst.iso
^^^ Who we are!
       ^^^ The Release name
                   ^^^ The architecture
                         ^^^ The Installation image

Needs fixed width to line up properly...

= {Pathing walk through of how to find the right .iso}


This useful information is beyond the scope of these INSTALL guides. But there are already pages on the website that cover much of it. Does it really need to be repeated?
https://devuan.org/os/releases
https://devuan.org/os/filenaming


# # Section:  Supported architectures

Define what both of these mean.

amd64:  64-bit CPUs, used for both Intel and AMD consumer level CPUs.
I386:  32-bit CPUs, ???


Again not really appropriate for the INSTALL guides. Hardware is soooo not my thing. If someone wants to do a write up, we can find a place for it somewhere on the website.


# # Section:  Installation images

Rename to “What Installation image should I chose?”


There has to be a more concise way of saying that. ;) Minimalism rules here. ;)


Add Subsection:  One install with access to the Internet?

Use the `*_netinst.iso` which will install a base system then download the
remaining packages during the installation process.

Add Subsection:  Multiple installs or no access to the Internet during
install?

Choose the single `*_dvd-1.iso`. The image contains several desktop choices
and additional software options. ...


That information is already on the index and get-devuan pages of the website as well as one of the links posted above. Those who will not seek will not find.


# # Section:  Check the integrity of images

Add how to for Windows. You can probably swipe Fedora’s? But someone would
need to check both copyright concerns and that the instructions work.

https://docs.fedoraproject.org/en-US/Fedora/18/html/Burning_ISO_images_to_disc/sect-Burning_ISO_images_to_disc-Validating_the_Files-Validating_at_the_Windows_Command_Prompt.html


Could you possibly provide that information for inclusion?


# # Check the integrity of images Vs. Verify the images

This isn’t my field, but??? If they’ve done a sha256sum, is there any value in checking a keychain? Or are these just two alternatives of the same thing
and these two sections need to be sub-sections of the same section?


I think they are alternative ways of verifying. I always do a sha256sum. Can someone please clarify?


# # Section:  Writing an image to a CD/DVD or USB drive

Okay, I hate giving people dd instructions, as one bad typo and they’ve
irrevocably wiped the wrong drive.
These instructions are much safer and
also allow the user to add scripts, commands, copies of .bashrc, and any
other ‘stuff’ that they might want post install to the USB.

Creating a bootable Ubuntu USB flash drive from terminal
https://askubuntu.com/a/376430

There is one additional command needed. In the next to last step you also
need to rename isolinux.bin to syslinux.bin.

This section also needs Windows instructions.


I'll let others speak to the technical merit of these suggestions.

In closing I just have to say . . . WOW! Windows, Ubuntu and Fedora mentioned in the same email. This has to be a first in all the years this list has existed. I must admit that pushed more than a few buttons . . .

Cheers!

# # #

Nice writeup, this will definitely help!

Best,
Michael


_______________________________________________
Dng mailing list
Dng@lists.dyne.org
https://mailinglists.dyne.org/cgi-bin/mailman/listinfo/dng

Reply via email to