void-linux / void-linux/void-docs
ROOTFS installation guide has issues
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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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