Opened 10 years ago

Closed 9 years ago

#4331 closed bug (invalid)

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

Reported by: Disreali Owned by: humdinger
Priority: normal Milestone: R1
Component: Documentation Version: R1/pre-alpha1
Keywords: Cc:
Blocked By: Blocking:
Has a Patch: no Platform: All

Description

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.

Change History (11)

comment:1 by humdinger, 10 years ago

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...

comment:2 by diver, 10 years ago

Component: - GeneralDocumentation
Owner: changed from axeld to nielx

in reply to:  1 comment:3 by Disreali, 10 years ago

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.

comment:4 by nielx, 10 years ago

Owner: changed from nielx to humdinger

User documentation is Humdinger's area. Reassigning.

comment:5 by humdinger, 10 years ago

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"?

in reply to:  5 comment:6 by bonefish, 10 years ago

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?

comment:7 by humdinger, 10 years ago

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.

comment:8 by mmadia, 10 years ago

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

in reply to:  8 comment:9 by koki, 10 years ago

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.

comment:10 by Disreali, 10 years ago

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

comment:11 by luroh, 9 years ago

Resolution: invalid
Status: newclosed

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

Note: See TracTickets for help on using tickets.