search

linuxboot / heads-wiki

Documentation for the Heads firmware project
85 stars 44 forks source link

OS support #99

Closed JonathonHall-Purism closed 2 years ago

JonathonHall-Purism commented 2 years ago

Includes changes related to https://github.com/osresearch/heads/pull/1188 as well as general OS recommendations discussed during that PR.

I included the qemu-coreboot-fbwhiptail-tpm1-hotp setup instructions, so maybe README.md in Heads should link here instead? On the other hand since these instructions may change, maybe it is better that they are versioned with Heads?

JonathonHall-Purism commented 2 years ago

Preview of changes:

https://jonathonhall-purism.github.io/heads-wiki/Emulating-Heads/ https://jonathonhall-purism.github.io/heads-wiki/InstallingOS/

tlaurion commented 2 years ago

@JonathonHall-Purism your questions in OP here are important for maintainership.

I tend to document board specific instructions in board configurations, but that might be impractical for users, while developers will understand.

Documenting into board config would ease maintainership, since changing a board config and its make statements and operations guidelines would directly reflect a specific commit.

I think you are completely right, and the current qemu relative documentation might be wiser to point directly into the board configuration, and have heads repo README and emulation guidelines point to the board configuration directly?

Otherwise by experience, we will change the boards and will forget to update the docs.

Unfortunately heads-wiki is separated from heads repo and this disjunction creates discreoencies and duplicate of efforts.

I wish we could merge the two and have heads rendered over osresearch.net only for the documentation section butnthisnis not how this is setuped right now.

@osresearch?