search

godarch / darch

A tool for building and booting stateless and immutable images, bare metal.
https://godarch.com/
MIT License
832 stars 32 forks source link

Clearer (finished) documentation on how to create a distro? #23

Open sosodev opened 6 years ago

sosodev commented 6 years ago

I love this concept, and I would love to be able to create my own image, but the documentation is seriously lacking.

pauldotknopf commented 6 years ago

Have you tried the quick start? https://godarch.com/test-drive/

Refer to my recipes for an implementation: https://github.com/pauldotknopf/darch-recipes

kwshi commented 3 years ago

@pauldotknopf I'm afraid this issue is even more relevant now, seeing as you've modified your personal recipes to build using Dockerfiles instead of Darch JSON configs, and you've expressed in #51 that building with Dockerfiles should be the way going forward, but the current documentation still only covers building with config.json's (making it a little more difficult to reference/understand your example recipes with no docs).

Furthermore, all of the "Advanced" pages under the documentation are still currently empty and marked "TODO".

I'm currently having a bunch of trouble trying to get any working system under Darch (see godarch/distributions#8), none of which has been addressed by the documentation; furthermore, I think the current documentation doesn't provide any information on how to produce a base image for a new distro, e.g. Fedora. I've started the discussion in godarch/distributions#8; if you could provide a few pointers there to help me figure out what's going on in the Dockerfiles, I'd gladly help improve the documentation in these areas once I get a better understanding of how they work!