Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 534376 - Gentoo Handbook for ARM architecture is missing
Summary: Gentoo Handbook for ARM architecture is missing
Status: RESOLVED WONTFIX
Alias: None
Product: Documentation
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: ARM Linux
: Normal normal
Assignee: Gentoo ARM Porters
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-01-02 21:40 UTC by Bernhard Nägele
Modified: 2023-07-21 10:27 UTC (History)
9 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Bernhard Nägele 2015-01-02 21:40:42 UTC
With the new style of Gentoo documentation based on MediaWiki the Gentoo Handbook for ARM-Architecture is missing.
Comment 1 Sven Vermeulen (RETIRED) gentoo-dev 2015-01-03 08:18:14 UTC
Hi Bernhard

Yes, this is done in good faith. The "old" ARM handbook was already marked as outdated and there were no editors/developers willing to update it. As a result, I did not move it anymore.

The trigger to create a new architecture handbook is one that I would expect from the developers that work on that architecture, because all I/we can do is edit on language style and structure, not on content. Moving erroneous instructions to a document as official as the handbook might generate more problems than they would fix.

I'm reassigning this to the ARM team to trigger them. If anything, a short set of installation instructions or resources are best placed on their project page at https://wiki.gentoo.org/wiki/Project:ARM.
Comment 2 Zulu Foxtrott 2021-02-16 08:02:04 UTC
I'm currently trying to document installing Gentoo on arm64:
https://wiki.gentoo.org/wiki/User:Zulu_Foxtrott (WIP)

Is there any consensus on how to approach the installation?

Specifically I have one question:

Should the installation process and the respective documentation start with creating bootable Gentoo media (installing Gentoo from there afterwards the traditional way)?

An alternative approach would be to install Gentoo directly to a storage device of choice (like a SD-Card, an eMMC, a USB stick, an external hard drive, etc.) from an arbitrary working Linux command-line environment (not necessarily  on a system of the same architecture as the target system). This might be especially useful on systems that only support one storage medium at a time or for which there is no installation media whatsoever available. It would also provide a shortcut in case the target device does support more than one storage medium at a time but no official Gentoo installation media is available for the target arch (usually in that case one would create bootable Gentoo media first or use some third party distribution instead and install Gentoo from there).
Comment 3 vince.ice 2021-02-16 10:36:16 UTC
(In reply to Zulu Foxtrott from comment #2)
> I'm currently trying to document installing Gentoo on arm64:
> https://wiki.gentoo.org/wiki/User:Zulu_Foxtrott (WIP)
> 
> Is there any consensus on how to approach the installation?
> 
> Specifically I have one question:
> 
> Should the installation process and the respective documentation start with
> creating bootable Gentoo media (installing Gentoo from there afterwards the
> traditional way)?
> 
> An alternative approach would be to install Gentoo directly to a storage
> device of choice (like a SD-Card, an eMMC, a USB stick, an external hard
> drive, etc.) from an arbitrary working Linux command-line environment (not
> necessarily  on a system of the same architecture as the target system).
> This might be especially useful on systems that only support one storage
> medium at a time or for which there is no installation media whatsoever
> available. It would also provide a shortcut in case the target device does
> support more than one storage medium at a time but no official Gentoo
> installation media is available for the target arch (usually in that case
> one would create bootable Gentoo media first or use some third party
> distribution instead and install Gentoo from there).

Thank you for dedicating your time for this task! Very very useful for the community!
I'd say the alternative approach would be more useful especially with all the little boards out there... But maybe one could think about creating a bivalent handbook that could eventually cover the first approach as well.

Can't wait to see the progress!
vince
Comment 4 Matthew Marchese Gentoo Infrastructure gentoo-dev 2023-07-21 10:27:10 UTC
As Sven Vermeulen said in #c1, the Handbook project has no intention to write a Handbook for ARM or AMD64, so we're going to close this as a WONTFIX. There are too many non-standard targets to write such a document for these computer architectures. We also lack the time and the knowledge required for such a task, so it's tempting to close this as a CANTFIX instead. :)

Sorry to our community who is disappointed with decision. If ARM or ARM64 projects wish to have a Handbook made available, the Handbook project would be available to help with formatting, etc.

That said, we do have the Embedded Handbook available on the wiki, which is in a namespace modifiable by any user with an account. It provides a lot of useful information for several ARM boards already.

Anyone coming here for a handbook style document, the Embedded Handbook is what you should be reading instead:

https://wiki.gentoo.org/wiki/Embedded_Handbook

Many community maintained Raspberry Pi articles also exist on the wiki. These can be discovered if desired.