void-linux / void-linux/void-docs

ROOTFS installation guide has issues

Open
#899 5 comments 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
CSS
Stars
217
Forks
212
Avg merge
2d 21h
Merged PRs (30d)
1

Description

Hi,

I searched but did only find mentions of the ROOTFS method in your scoping issue #85.

Following through this ROOTFS method described in https://github.com/void-linux/void-docs/blob/master/src/installation/guides/chroot.md has caveats:

The ROOTFS method requires only a host operating system that can enter a Linux chroot and that has both tar(1) and xz(1) installed. This method may be preferable if you wish to install Void using a different Linux distribution.

If this intent is to be kept, it misses guidance how to acquire theVoid package manager and installation tools.

It mentions being able to enter a chroot as pre-requisite, but never instructs the user when to do so. The user will encounter the issue first, when instructed to use xbps-install, which is no requisite for this method, at https://github.com/void-linux/void-docs/blob/master/src/installation/guides/chroot.md#the-rootfs-method.

Yes, one can chroot /mnt and manually fix its resolv.conf at that point, but then the xbps-install commands given (with -r /mnt) are nonsensical to me.

It continues at the point where both methods are supposed to be identical. The host still has no xgenfstab/xchroot to follow through with this guide.

Maybe the pre-requisites for this guide miss the same static xbps as the first (xbps) method?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with src/installation/guides/chroot.md, especially the ROOTFS method and the shared configuration section. Compare its prerequisites and commands with the xbps method and the static xbps troubleshooting guide, then verify that the documented ROOTFS path explains how to obtain the required tools and can be followed without unexplained host commands.

Written by the indexing model from the issue text.

Assessment

Tech stack
linux
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.