My personal project and infrastructure archive
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

63 lines
2.9 KiB

7 months ago
7 months ago
  1. <div align="center">
  2. <img src="docs/logo.png" height="256px"/>
  3. <h1>kookienomicon</h1>
  4. </div>
  5. Welcome to the *kookienomicon*, my personal project archive. Here you
  6. will find tools, libraries, and prototypes that I have written in the
  7. hopes that they might one day be useful to future-me, or future-you.
  8. Be warned though, there's software ahead ~✨
  9. ## Structure
  10. Following is an overview of components in this repository.
  11. | Directory | Description |
  12. |------------------------------|--------------------------------------------------------------------------------|
  13. | [apps](./apps) | Applications (graphical and command-line) meant for end-users |
  14. | [development](./development) | Libraries and specific tools primarily meant to be used by software developers |
  15. | [docs](./docs) | Documentation for the kookienomicon |
  16. | [games](./games) | Free software games and game tools |
  17. | [infra](./infra) | Personal infrastructure projects (namely `libkookie` & my website) |
  18. | [junkyard](./junkyard) | Projects I've abandoned and that are considered read-only archives |
  19. | [licenses](./licenses) | Set of license texts in use by projects in this repository |
  20. | [nix](./nix) | Nix build files and utilities |
  21. | [prototypes](./prototypes) | Small experiments that don't fit anywhere else |
  22. ## Contributing
  23. Because the kookienomicon is hosted on a platform that doesn't allow
  24. public signup, contributing via PRs is not possible. Instead, if you
  25. want to provide an update to any of the projects hosted in this
  26. archive, you can do so via e-mail. You can either send a [set of
  27. patches] to my [public inbox], or host your changes somewhere and send
  28. me an e-mail [pull request].
  29. For additional help on how to set up git's e-mail tools go [here].
  30. [set of patches]: https://spacekookie.de/blog/collaborating-with-git-send-email/
  31. [public inbox]: https://lists.sr.ht/~spacekookie/public-inbox
  32. [pull request]: https://www.git-scm.com/docs/git-request-pull
  33. [here]: https://git-send-email.io/
  34. ## Working with a large repo
  35. This repository is quite massive, because it contains multiple
  36. subtrees with large histories.
  37. If you experience performance problems, try setting
  38. `feature.manyFiles` in your git configuration. Additionally, when
  39. using `git log`, make sure to use `--first-parent` to get the history
  40. of kookienomicon, instead of the merged subtree histories.
  41. ## License
  42. This repository has no unified license. Check each project for it's
  43. specific license. Licenses in-use by projects in this repository can
  44. be found in the `licenses` directory.