Dwarves Memo

✍ https://memo.d.foundation ✍
The vault of knowledge where we keep our internal notes from everything related to our engineering practices, new tech we are learning, and as well as business and hiring notices

About this project

This is the repository where we keep our internal notes. We use this repo to share our knowledge, insights, and experiences with each other before we make it generally available to our community.

Getting Started

We welcome contributions from anyone who is interested in our topics. You can contribute by creating a new note, editing an existing note, or commenting on a note. To do so, you need to follow these steps:

1. Fork this repo and clone it to your local machine.
2. Install Devbox, a command-line tool that lets you easily create isolated shells and containers for development. Devbox will help you set up a consistent and reproducible environment for this repo, with all the necessary tools and dependencies installed.
3. Run devbox shell in the root directory of the repo to enter an isolated shell.

To run the server, you can run our Makefile command:

make run

or through devbox:

devbox run run

Search Index

The app uses client-side search with MiniSearch. To improve build performance and reduce page size, we generate a separate search index file during the build process:

pnpm run generate-search-index

This script creates a static JSON file at public/content/search-index.json that's loaded dynamically by the client when needed, instead of being included in every page's props.

Code of conduct

We expect all contributors to adhere to our code of conduct, which is based on the Contributor Covenant. By participating in this project, you agree to abide by its terms. Please report any unacceptable behavior to [email protected].

Credits

A big thank to all who contributed to this project!

If you'd like to contribute, please check out the the above Code of conduct guide.