[UserGuide] Incomplete info on /userguide/en/installation.html

[Disreali]

​http://svn.berlios.de/viewcvs/*checkout*/haiku/haiku/trunk/docs/userguide/en/installation.html

The sections on 'Installing from a downloaded RAW image' and 'Compiling/Installing from source code' only have one line underneath with 'text' repeated several times.

It would be nice to have a simple 2-3 sentence summary of the topic replace the line of "text" be fore the alpha is released.

[humdinger]

The thing is, the whole installation issue is not supposed to be part of the user guide. It was planned, but after further thought removed again. All documents are in various stages of accuracy. At least the install-source-linux.html is regularly linked to directly to the SVN browser and is in an OK state, IIRC.

Can we exclude installation.html and the whole installation folder from the user guide?

I'm a bit hesitant to just delete it from SVN...

[Disreali]

I would definitely not like to see the installation.html removed from SVN, and do not understand the reason for excluding it in the release. Is it simply that the page is not in a satisfactory state? Every operating system user guide I have every read has at least a short summary of how to install the OS.

[nielx]

User documentation is Humdinger's area. Reassigning.

[humdinger]

How to build Haiku from source isn't something essential for the targeted end using reader of the user guide. The official way for installation is already described under applications -> Installer.

Could someone more familiar with the build system please exclude docs/userguide/en/installation.html and the whole folder docs/userguide/en/installation/ from the OptionlPackage "Welcome"?

[bonefish]

Replying to humdinger:

Could someone more familiar with the build system please exclude docs/userguide/en/installation.html and the whole folder docs/userguide/en/installation/ from the OptionlPackage "Welcome"?

Not sure what your reasons for not removing the file/folder are. If the information, while not up to date, are still useful, but are just not suitable for the user guide, why not simply move them to a more suitable place outside the user guide?

[humdinger]

The only reason would be that the install-source-linux.html has been linked to quite a few times. So it would be inconvenient for some to break this link. OTOH, it's nothing official really...
So, moving... how about docs/build/. I have no idea how accurate the other docs are, though.

[mmadia]

I personally would like to see the information at ​http://svn.berlios.de/svnroot/repos/haiku/haiku/trunk/docs/userguide/en/installation/ be merged with ​http://www.haiku-os.org/node/2500

Reason: more people have easier access to edit the content.

As for install-source-linux.html, it could simply include a url for the user to manually redirect to the new location

[koki]

Replying to mmadia:

I personally would like to see the information at ​http://svn.berlios.de/svnroot/repos/haiku/haiku/trunk/docs/userguide/en/installation/ be merged with ​http://www.haiku-os.org/node/2500

I would love to see this happen too.

[Disreali]

Since the release, most of the questions I see on #haiku are related to installation, especially installing to and from a USB stick. This needs to be finished and added back to the user guide. It is to late for the release, but would help many that visit Haiku-os.org

[luroh]

Closing as invalid since the User Guide no longer covers installation from source and the file in question has been removed from the repository.