168 lines
7.9 KiB
Markdown
168 lines
7.9 KiB
Markdown
---
|
|
title: start
|
|
---
|
|
|
|
## About
|
|
|
|
{{< icon "chat" >}} benjamin@tinytechbureau.com<br>
|
|
{{< icon "feed" >}} <a href="/index.xml">RSS feed</a><br>
|
|
{{< icon "fan" >}} <a href="https://social.data.coop/@benjaoming">Follow on the Fediverse</a>
|
|
|
|
Tiny Tech Bureau (WIP) produces sustainable and creative tech solutions based on open-source components.
|
|
|
|
We've learned that reducing the size of tech solutions, in turn reduces their complexity and harmfulness. We're critical that tech is the answer to all problems, and therefore we're a very trustworthy consultancy partner for building such solutions. We can produce end-to-end solutions: From designing and planning your project — to crafting digital tools and products that fit your users and your workflows, using our expertise with a durable open source tech stack.
|
|
|
|
*We* are me, [Benjamin Balder Bach](https://overtag.dk/), and any freelance friends that I work with in this new setting.
|
|
|
|
## Values and methods {{< icon "bulb" >}}
|
|
|
|
Here are the most important methods and principles that we work with:
|
|
|
|
<form>
|
|
<div class="collapsible-bar">
|
|
|
|
<input type="checkbox" value="no-harm" name="vision" id="no_harm">
|
|
<label class="collapsible-title" for="no_harm">
|
|
|
|
### First, do no harm {{< icon "expand" >}}
|
|
|
|
</label>
|
|
|
|
<div class="collapsible-content">
|
|
When building a solution with tech, firstly analyze the present situation to understand how it works and what solutions are already in place. We want to learn from this and inform the next solution.
|
|
|
|
In many ways, like doctors take a hippocratic oath, technology workers can also pledge that they a) will not build a hammer and then look for nails, we will take an approach whereby the needs are understood firstly and b) we will use our knowledge of data, security and access to enforce the rights of users in an ethical way.
|
|
</div>
|
|
|
|
</div>
|
|
<div class="collapsible-bar">
|
|
<input type="checkbox" value="no-harm" name="vision" id="meaningful">
|
|
<label class="collapsible-title" for="meaningful">
|
|
|
|
### Meaningful technology {{< icon "expand" >}}
|
|
|
|
</label>
|
|
|
|
<div class="collapsible-content">
|
|
The sensitivity of the do no harm principle extends into understanding the meaning that technology has to users. Firstly, we build it based on their needs, secondly we test it with them to get their acceptance. Adding technological layers can easily be a tempting ride whereby unnecessary data and procedures are added. In programming, we apply the principle of YAGNI (you aren't going to need it), same principle is relevant when we build a user experience.
|
|
|
|
It's much like Occam's Razor, the less we assume about our user's needs, the more likely we are to have identified the correct solution, as in the combination of user experience and technology stack that's most efficient on both a short and long term.
|
|
|
|
But when we look for simplicity and meaning, we need to be aware that users are different and social interactions can be complex. This doesn't mean necessarily that Occam's Razor isn't true, but we need to account for everything. Or as Einstein said: Everything should be made as simple as possible, but not simpler.
|
|
|
|
</div>
|
|
|
|
</div>
|
|
<div class="collapsible-bar">
|
|
<input type="checkbox" value="code" name="vision" id="code">
|
|
<label class="collapsible-title" for="code">
|
|
|
|
### Public Code {{< icon "expand" >}}
|
|
|
|
</label>
|
|
|
|
<div class="collapsible-content">
|
|
Open Source contains a moral of giving back. It's not that we need to give away useless source code or expose sensitive data, but more that we understand that the tools we are given for free, obliges us to take part in something bigger.
|
|
|
|
As a publicly owned entity, this has become an overall thinking that includes using the enormous capacity of the public sector to participate in Open Source. In fact, this is already known to be beneficial to build sovereign systems and as an economically superiour model. On all levels of the public sector, it makes sense
|
|
|
|
</div>
|
|
|
|
</div>
|
|
<div class="collapsible-bar">
|
|
<input type="checkbox" value="source" name="vision" id="source">
|
|
<label class="collapsible-title" for="source">
|
|
|
|
### Open Source stewardship {{< icon "expand" >}}
|
|
|
|
</label>
|
|
|
|
<div class="collapsible-content">
|
|
|
|
As one of the many concepts that have evolved in the push for more Public Code, is the Open Source stewardship. As much as we believe in sharing code, we believe in sharing experiences. The idea of stewarding open source, is not one of being in power or control. It's based on principles of taking responsibility to make sure that a project uses existing experiences and tools to emerge.
|
|
|
|
Once the strategy is in place, software designers and developers can benefit from guidance at the inception of their project and along the way. We want more than just a LICENSE file in the repository. We want documentation, stakeholders and community around the project that can ensure its sustainability.
|
|
|
|
</div>
|
|
|
|
</div>
|
|
<div class="collapsible-bar">
|
|
|
|
<input type="checkbox" value="health" name="vision" id="health">
|
|
<label class="collapsible-title" for="health">
|
|
|
|
### Healthy software {{< icon "expand" >}}
|
|
</label>
|
|
|
|
<div class="collapsible-content">
|
|
|
|
Code and technology indeed withers over time when it isn't cared for. Software projects build up technical debt naturally, and the question is when that technical debt becomes an existential threat.
|
|
|
|
One of the reasons for minimizing a tech stack or being fairly skeptic about technologies is to ensure the longevity of software. A great software platform doesn't look outdated a few years down the road. You know that if you have used software with a very strong and relevant concept.
|
|
|
|
</div>
|
|
|
|
</div>
|
|
<div class="collapsible-bar">
|
|
|
|
<input type="checkbox" value="code" name="vision" id="corealization">
|
|
<label class="collapsible-title" for="corealization">
|
|
|
|
### Co-realization {{< icon "expand" >}}
|
|
|
|
</label>
|
|
|
|
<div class="collapsible-content">
|
|
|
|
Sharing contexts means to take part in the world of users and other stakeholders.
|
|
|
|
There are several reasons why it makes sense for developers and designers to share as much context as possible with other stakeholders, especially users. Firstly, it makes developers able to become designers and make more qualified proposals. But secondly, it also helps to prioritize in harmony.
|
|
</div>
|
|
|
|
</div>
|
|
<div class="collapsible-bar">
|
|
|
|
<input type="checkbox" value="rapid" name="vision" id="rapid">
|
|
<label class="collapsible-title" for="rapid">
|
|
|
|
### Rapid development {{< icon "expand" >}}
|
|
</label>
|
|
|
|
<div class="collapsible-content">
|
|
|
|
The idea of "rapid development" has a long historical run-way, leading up to ideas like "ship early, ship often", agile programming methodologies etc.
|
|
</div>
|
|
|
|
|
|
</div>
|
|
</form>
|
|
|
|
## Tools: The technical concept
|
|
|
|
In order to build and deliver something that aligns with our methods, we *currently* use things like:
|
|
|
|
* Django [^1] and Python
|
|
* Wagtail CMS [^2]
|
|
* Static site generators (Hugo[^3] and Sphinx[^4])
|
|
* CSS and SCSS
|
|
* Minimal JavaScript (such as htmx[^5])
|
|
* Containerization for development setups and testing
|
|
* Pytest [^6]
|
|
* FastAPI [^7], django-ninja [^8]
|
|
* CI for testing and linting
|
|
* Documentation, using Diátaxis
|
|
|
|
The general idea is to always align with what we perceive as the best practices to reach our vision. Using the flexibility of such a stack, you can develop any website or web app at small or large scale.
|
|
|
|
Having a test strategy is important. And a CI version of testing is crucial to guarantee correctness and allow a fast path to changes. However, we also see testing as something that needs careful crafting - tests need to be meaningful in all aspects of a solution.
|
|
|
|
If you're familiar with other tech stacks, you'll notice the absence of containerized deployment and big JavaScript frameworks. These add the kind of complexity to a project that will make it expensive to bootstrap and maintain over a longer period of time.
|
|
|
|
[^1]: https://djangoproject.com
|
|
[^2]: https://wagtail.org
|
|
[^3]: https://gohugo.io/
|
|
[^4]: https://www.sphinx-doc.org/
|
|
[^5]: https://htmx.org/
|
|
[^6]: https://pytest.org/
|
|
[^7]: https://fastapi.tiangolo.com/
|
|
[^8]: https://django-ninja.dev/ |