Troumotas

File Storage: Notes From Practice

May 1, 2022 · Ian Fletcher · 13 min read

We dropped several external dependencies and never looked back. We keep a changelog so it is always clear what changed and when. A good layout starts with the text, not with the pictures. People rarely read manuals, so hints have to be short and specific. This section collects answers to the questions we hear most often.

We try to write code that will still be easy to read a year from now. Configuration details are covered in the following sections. The design system grew from a couple of pages of notes into a full reference. Good documentation saves more time than any optimization.

Planning

Here is the story in order. These pages are updated whenever a new version ships. Tests do not guarantee the absence of bugs, but they make bugs cheaper. Most of the interface is built from a small set of reusable components. Some processes are automated, but key decisions are still made by hand. Moving the build to a dedicated machine made releases much calmer.

These pages are updated whenever a new version ships. People rarely read manuals, so hints have to be short and specific. Configuration details are covered in the following sections. The most useful ideas came from people who use the product every day. The hardest part was not the code but agreeing on how the team should work. Early feedback was cautious, but a month later the picture had changed.

Thanks to everyone who sent comments and suggestions. Sometimes the best fix is removing something instead of adding a feature. If something does not work as described, let us know and we will fix the text. Most of the interface is built from a small set of reusable components.

pip install troumotas-client
python -m troumotas_client --check
Testing