lemanschik / awesome

A Magic Repository Started By a Magic Number enables git tree submodule branch flows.
1 stars 2 forks source link

Documentation: Explain the awsome repository Structure #29

Open lemanschik opened 1 year ago

lemanschik commented 1 year ago

Awsome Repo

This is a magical repo it consists mainly out of references but it is not a clean reference only repo It also combines the partial worktree checkout patterns and also includes some legacy repos as branches The awsome comes from the fact that we work with a single repo on the largest code bases in the world. via standard git patterns that existed since ages without additional tooling or invention on top of it.

Simple correct usage of existing patterns improves your build process by Infinity n already.

Features

Single Branch Module Checkout and Development

You can checkout a single branch and then work directly on it after that you push the branch back if you need additional modules you can in your existing single branch clone simple add a other branch as submodule and simple not checkin the submodule changes. or you directly use the work tree checkouts that are by design temporary you can with them create a virtual new branch of the existing to work with.

Unlimited version compositions reference able via tags and other meta

You can combine anything out of text into larger text and throw it into compilers and get directly compiler feedback no matter where the compiler runs.

Use Google Development Patterns without tools

Google and so the Chromium project did come up with a lot of patterns to address code challenges in large repos that includes a series of tools this aims to replace them with correct workflows and without additional tooling.