Monorepo vs. Multirepo

Jump to bottom Edit New page

Steve Hollasch edited this page Aug 27, 2019 · 7 revisions

With multirepo, each book/project gets it's own repository. With monorepo, a single repository contains all content for all books and projects.

Multirepo Advantages

Each book/project is independent of changes made to other books. If a piece of similar code is corrected in another book or project, you don't need to take the fix in a different book until you're ready to address it.
Book URL: https://raytracing.github.io/InOneWeekend/

Monorepo Advantages

Shared resources such as release tools, book CSS, Markdown scripts, project documents and so forth have a single source, and need not be copied+added+committed+pushed+PR'd to multiple locations.
To get the entire suite, you only need to clone a single repo, or download a single package.
The project gets a clear common version number.
Getting the latest versions is accomplished with a single git pull, rather than having to go to multiple clones to pull from each.
Book URL: https://raytracing.github.io/InOneWeekend/ (if monorepo is raytracing.github.io, subdir InOneWeekend)
Book URL: https://raytracing.github.io/RayTracing/InOneWeekend (if monorepo is RayTracing)