From f7ec046bc5b72786c563406a50f8b160ce731dd6 Mon Sep 17 00:00:00 2001 From: Benjamin Bach Date: Tue, 9 Jul 2024 19:30:21 +0200 Subject: [PATCH] More content yay --- content/_index.md | 4 ++++ content/blog/api-design-and-frameworks.md | 24 +++++++++++++++++------ themes/ttb/layouts/partials/head.html | 1 + 3 files changed, 23 insertions(+), 6 deletions(-) diff --git a/content/_index.md b/content/_index.md index e053e79..aed7854 100644 --- a/content/_index.md +++ b/content/_index.md @@ -132,6 +132,10 @@ There are several reasons why it makes sense for developers and designers to sha
The idea of "rapid development" has a long historical run-way, leading up to ideas like "ship early, ship often", agile programming methodologies etc. + +With rapid development, we mean that the developer should participate in the context/domain that the software seeks to solve problems and create value in. The developer needs direct feedback from seeing the software in use. + +This in turn saves costly interactions and translations across actors. By fixing the problem here and now, we don't risk that the context is diluted, nor that elements are lost in transmission or translation between designers and managers. By letting the programmer be the designer, we in turn push responsibility and initiative to the user that gets to instruct the programmer directly. These methods are known also as co-realization and to expand "design space".
diff --git a/content/blog/api-design-and-frameworks.md b/content/blog/api-design-and-frameworks.md index 43841fd..42d8427 100644 --- a/content/blog/api-design-and-frameworks.md +++ b/content/blog/api-design-and-frameworks.md @@ -13,17 +13,29 @@ We're focusing on choice and preferences. The objective is to make something tha Ingredients: -* Open up your own design doc/enhancement proposal and start writing -* The method -* Some components for evaluation -* tl;dr Conclusion +1. Open up your own design doc/enhancement proposal and start writing +2. Establish your method +3. Choose components for evaluation +4. tl;dr Conclusion One of the reasons why it's good to have this approach, is that most ORMs and API frameworks can be decoupled. But it's good to narrow down your search from the beginning. If you already have a strong preference for SQLAlchemy or Django, you should be comfortable with that choice. ## The method -At the beginning, you should probably wonder about what criteria are important +At the beginning, you should decide what criteria are important for your project: + +* Do you want to build a prototype? +* Should others from your team participate in the evaluation? +* What should be the final outcome? + +In my experience, it's worked great to do the following: + +* An evaluation of any current setup and needs together with others from the team. +* Opening a draft design doc to capture all decisions and observations. +* Writing prototypes and doing small demos. + +## Components for evaluation + -## Th ## More resources \ No newline at end of file diff --git a/themes/ttb/layouts/partials/head.html b/themes/ttb/layouts/partials/head.html index 03bef31..2f78bb7 100644 --- a/themes/ttb/layouts/partials/head.html +++ b/themes/ttb/layouts/partials/head.html @@ -3,6 +3,7 @@ {{ if .IsHome }}{{ site.Title }}{{ else }}{{ printf "%s | %s" .Title site.Title }}{{ end }} {{ with .Site.Params.description }}{{ end }} {{ with .Site.Params.author }}{{ end }} + {{ template "_internal/twitter_cards.html" . }} {{ template "_internal/opengraph.html" . }}