You are not logged in.

#1 2012-08-07 00:10:18

Registered: 2011-12-30
Posts: 71

Troubleshooting for Installagion/Beginners Guide

I find that some people are having trouble with the new installation process (e.g. '/boot/grub' is not readable by GRUB on boot). I find that one of the issues was that one made the wrong order on mounting and directory creation and - while obvious - could need a little help on fixing those errors as the message don't even point in the right direction.

So here's my suggestion: Add a troubleshooting section or extra page for the installation process. We expand it over time as soon as see some errors appear often. Causes of the error and the best solution will be listed on this page, any user will look at this before posting in the forum (or at least should) and can avoid posts on errors that repeat.

Before I just start with a new wiki page, I'd like to hear your opinion. If you think this is a good idea here is my appraoch: Create the page, fill it with the first information (I have one issue in mind so far) and then mention it at at least one important section in the guides so people know it exists. What do you think?



#2 2012-08-07 00:28:17

Forum Fellow
From: Between Thailand and Singapore
Registered: 2009-03-17
Posts: 7,226

Re: Troubleshooting for Installagion/Beginners Guide

Those having trouble should search for solutions. If they don't/won't/can't, they're not going to enjoy using Arch, and the community isn't going to enjoy having them.

Allan-Volunteer on the (topic being discussed) mailn lists. You never get the people who matters attention on the forums.
jasonwryan-Installing Arch is a measure of your literacy. Maintaining Arch is a measure of your diligence. Contributing to Arch is a measure of your competence.
Griemak-Bleeding edge, not bleeding flat. Edge denotes falls will occur from time to time. Bring your own parachute.


#3 2012-08-07 01:16:56

Forum Moderator
Registered: 2012-01-15
Posts: 2,575

Re: Troubleshooting for Installagion/Beginners Guide

I am happy to see you taking an interest in the documentation. Having said that, I'd rather see common problems used to improve the actual Guide (if there is something that many people have problems with, we should try to fix the Guide).

For example, if you think the Guide isn't clear enough about the mount order, we should clarify it in the Guide, rather than in a separate troubleshooting section.

If you have another issue in mind, perhaps the Guide could be improved to solve that issue as well.

ngoonee is also right -- we will never be able to make the guide cover everything, and people need to learn how to solve problems by doing some research.

Last edited by 2ManyDogs (2012-08-07 01:17:43)


Board footer

Powered by FluxBB