You are not logged in.

#1 2005-10-28 22:06:38

Kern
Member
From: UK
Registered: 2005-02-09
Posts: 464

arch installation guide

Does anyone else think we need a more prominent link to the full arch install guide ?

Quick test, start at archlinux.org homepage and try and find it.

just pointed a guy at it, and unless it's me and i've missed an obvious link, it seems to be well tucked away, and maybe difficult for newbs to find.
Unless of course its an initiative test smile

maybe from that a pointer to the devfs/udev Cactus sticky?

Offline

#2 2005-10-28 22:40:48

elasticdog
Member
From: Washington, USA
Registered: 2005-05-02
Posts: 995
Website

Re: arch installation guide

Yeah, I agree...I've wanted to reference it a couple of times and had to take some time to track it down.  It should definitely be more prominent...perhaps linked to on the front page of the wiki?

Offline

#3 2005-10-28 23:25:37

dtw
Forum Fellow
From: UK
Registered: 2004-08-03
Posts: 4,436
Website

Re: arch installation guide

I think it should be flat out rewritten and I expect it will be in due course.  I have only ever installed Arch once so I won't be much good to anyone smile

Offline

#4 2005-10-28 23:30:01

Dusty
Schwag Merchant
From: Medicine Hat, Alberta, Canada
Registered: 2004-01-18
Posts: 5,986
Website

Re: arch installation guide

I think it should be moved from official docs to the wiki so it can be maintained. :-)

Dusty

Offline

#5 2005-10-28 23:31:59

High|ander
Member
From: Skövde, Sweden
Registered: 2005-10-28
Posts: 188
Website

Re: arch installation guide

i think it would be nice for newbies to have... Like the gentoo-handbook


When death smiles at you, all you can do is smile back!
Blog

Offline

#6 2005-11-04 03:59:23

ozar
Member
From: USA
Registered: 2005-02-18
Posts: 1,681

Re: arch installation guide

Agreed... the link to the official archlinux install guide isn't as prominent as it probably should be.  Even though I know where it is, I fumble around looking for it at times.   

As for documentation styles, I prefer the handbook style for the initial base installation, but the wiki is really cool for all that fine tuning that comes next.


oz

Offline

#7 2005-11-04 04:11:17

kensai
Member
From: Puerto Rico
Registered: 2005-06-03
Posts: 2,475
Website

Re: arch installation guide

It needs to be more visible and need almost a complete rewrite. Although I have never used (except the first day installing arch) it maybe can take some changes in the way it addresses thing like in a gentoo handbook way. wink


Follow me in: Identi.ca, Twitter, Google+

Offline

#8 2005-11-04 14:34:45

Dusty
Schwag Merchant
From: Medicine Hat, Alberta, Canada
Registered: 2004-01-18
Posts: 5,986
Website

Re: arch installation guide

vermin wrote:

I will be assisting Dennis in maintaining the documentation.

More likely, you'll be taking it on single-handedly... 8-) That's awesome though, we have active documentors again! :-)

In addition, expansion and (some) rewrite of the documentation will also take place.

Some advice, don't worry too much about expansion. If you can put it in the wiki, it tends to maintain itself, otherwise you are overwhelmed with maintenance. Some things currently in the wiki really should become standard arch docs though (dibble's cvs/svn package guidelines, my Java packaging guidelines [are these even in the wiki yet?], for example).

Dusty

Offline

#9 2005-11-04 15:39:07

dtw
Forum Fellow
From: UK
Registered: 2004-08-03
Posts: 4,436
Website

Re: arch installation guide

I agree with both of those - my custom kernel thing is considered indispensible by many was well tongue

Offline

#10 2005-11-04 23:05:44

Dusty
Schwag Merchant
From: Medicine Hat, Alberta, Canada
Registered: 2004-01-18
Posts: 5,986
Website

Re: arch installation guide

dibblethewrecker wrote:

I agree with both of those - my custom kernel thing is considered indispensible by many was well tongue

Hmmm... yeah, indespensible, but also oft-maintained. I think its better off in  a wiki than an official doc.

Actually, its a PKGBUILD, it could almost go in AUR.... hmmm....


Dusty

Offline

#11 2005-11-11 03:41:21

Nattydraddy
Member
From: Hamburg in Germany
Registered: 2005-11-01
Posts: 18

Re: arch installation guide

Kern wrote:

Does anyone else think we need a more prominent link to the full arch install guide ?

Quick test, start at archlinux.org homepage and try and find it.

just pointed a guy at it, and unless it's me and i've missed an obvious link, it seems to be well tucked away, and maybe difficult for newbs to find.
Unless of course its an initiative test smile

maybe from that a pointer to the devfs/udev Cactus sticky?

I made the test and needed many klicks to find the manual. And fist a wosn´t bei the offical Archlinx Installiation Guide. I looked under "I" and came to an installtions guide that stated that i must have a computer with archlinux installed.

Archlinux isn´t my first installiation. Slackware and Debian in old times were much more complicated. But the manual to install it was directly in front of you. We should deliver it with archlinux as well. Otherwise we couldn´t say to them: "Read the fucking manual!"

Offline

#12 2005-11-11 06:57:56

fdac
Member
From: Brisbane, Australia
Registered: 2005-06-19
Posts: 96

Re: arch installation guide

The manual is included with the Arch 0.7 install CD, and I believe the screen you get at boot with the CD tells you how to read it, including using a different virtual console for the docs.

However, I agree there needs to be better organisation of some aspects of documentation.  I think the install guide should be part of the Wiki along with all the other essential bits and pieces in there.

Cheers
Francis

Offline

Board footer

Powered by FluxBB