Assimilate Emacs packages as Git submodules

For more information see the announcement and the manual.

About borg.el

Borg is a bare-bones package manager for Emacs packages. It provides only a few essential features and should be combined with other tools such as Magit, epkg, use-package, and auto-compile.

Borg assimilates packages into the ~/.emacs.d repository as Git submodules. An assimilated package is called a drone and a borg-based ~/.emacs.d repository is called a collective.

About this collective

This particular collective is intended to be used to bootstrap private configurations. Fork your own copy and then start assimilating as you please.

If you wish you can later merge changes from the upstream repository, to get updates for the drones that have been assimilated in the base configuration. Very rarely additional drones might be assimilated or the configuration of existing drones might be tweaked.

Or you can just update and further configure these drones as you would update the drones you have assimilated yourself.

If you do base your own configuration on this collective and make it publically available as source of inspiration for others, then please do so by forking the upstream repository, which is available from Github, Gitlab, and Bitbucket.

You might also want to adjust this description.

Other collectives

It is also possible to create collectives that can be shared between and worked on by many Emacs users, i.e. borg-based starter-kits. Check out alternative collectives by browsing the repositories owned by the emacscollective organisation/group/team, which is available on Github, Gitlab, and Bitbucket.

Another alternative is the bootstrap collective. It assimilates a single drone, borg itself, and is intended for users for whom even the emacs.g collective is to opinionated.