darch icon indicating copy to clipboard operation
darch copied to clipboard

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

Open sosodev opened this issue 7 years ago • 2 comments

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

sosodev avatar May 27 '18 02:05 sosodev

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

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

pauldotknopf avatar May 27 '18 04:05 pauldotknopf

@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!

kwshi avatar Oct 22 '20 06:10 kwshi