Start working on the draft post

rauhala.info/index.markdown

@@ -5,18 +5,16 @@ title: Mats Rauhala
 ![](./images/profile.jpg)
 
 I'm a software developer from southern Finland. I'm currently working as a
-Haskell developer at Relex Oy involved in an internal tool. I also have
+Haskell developer at Relex Oy. I also have experience with systems integrations
-experience with systems integrations and backend web development.
+and backend web development.
-
-I'm also an aviation enthusiast. I have a glider pilots license and a touring
-motor glider pilots license (LAPL(S)+TMG).
 
 My [GPG key](./resources/0x9DE6E04ED1918118.txt)
 
 ### Notable experience and interests
 
 - **Relex Oy**
-  - Working as a Senior Software Developer at Relex Oy
+  - Working as a Lead Software Developer at Relex Oy
+  - Transitioned from day to day code to a role more close to an architect
   - Three distinct products, all of which written in Haskell
     - Internal integration tool
     - Relex Deploy 1, a tool for deploying the core product to hosts

rauhala.info/posts/2022-08-19-design-docs.md

@@ -0,0 +1,41 @@
+---
+title: Design Documents
+tags: design
+---
+
+We had a problem at work some time ago, with implementing features faster than
+we could refine new items. The roadmap was a mile long, but the quality of our
+work items left a lot to desire. The solution was to have more concerted effort
+into the act of designing and refining. One part of this effort was the
+introduction of design documents to our workflow.
+
+[Design Documents at Google](https://www.industrialempathy.com/posts/design-docs-at-google/)
+
+![](/images/sample-designdoc.png)
+
+We have been experimenting on using design documents for a little over half a
+year now and have been able to refine them to suit our processes quite nicely.
+Feel free to read the article above, it's a concise explanation on how they're
+using design documents, and what I'm going to write is going to focus on a
+subset of the article, on the aspects that I have found to be important.
+
+## What are design documents
+
+![stakeholder-architect-design-loop](/images/stakeholder-architect-design.png)
+
+When designing a new feature, the stakeholders have a set of requirements they
+need fulfilled. The product owner collects the requirements and provides them
+to the architect to be solved. It's this solution, that needs to be portrayed
+by the design document. The design document should portrey the high-level view
+of the design, without implementation details, in a way that the developers can
+take the design and implement a concrete solution.
+
+### What should the design document contain
+
+> A feature to add items to a shopping cart. The items needs to be reserved in
+the backend so that the reservation is synced across different users.
+
+The design document should be written on a high level, it should explain the
+problem and it should explain the solution for it, but it should not be the
+implementation guide. The design document should not contain any code or
+pseudocode in it.

rauhala.info/well-known/keybase.txt

@@ -1,111 +0,0 @@
-==================================================================
-https://keybase.io/masser
---------------------------------------------------------------------
-
-I hereby claim:
-
-  * I am an admin of https://masser.keybase.pub
-  * I am masser (https://keybase.io/masser) on keybase.
-  * I have a public key ASD7WFMicMJhoArgnvPuR7Dc92WStIUWWXcyngnsTE_IaQo
-
-To do so, I am signing this object:
-
-{
-  "body": {
-    "key": {
-      "eldest_kid": "01202eb5d3b8d2fc63e4bc9c6edefb3a38f1043dfdc44a7268393951fe0ea5214cf00a",
-      "host": "keybase.io",
-      "kid": "0120fb58532270c261a00ae09ef3ee47b0dcf76592b485165977329e09ec4c4fc8690a",
-      "uid": "b01557931e13482e9e646593a64e9119",
-      "username": "masser"
-    },
-    "merkle_root": {
-      "ctime": 1580587604,
-      "hash": "890506579950548b2aa6fd0f35850b9fdb1d064786714f18515d0e3089cdc2458c5fe847d40ca71c2e021ca11677de055ac97804c53d1bef89432f88b57599d4",
-      "hash_meta": "104419595abc52918530f85495417faf35c7a5a608d6730bf53152dfa7288970",
-      "seqno": 14451686
-    },
-    "service": {
-      "entropy": "QIvRp0qNOIZFplyzXERiwp75",
-      "hostname": "masser.keybase.pub",
-      "protocol": "https:"
-    },
-    "type": "web_service_binding",
-    "version": 2
-  },
-  "client": {
-    "name": "keybase.io go client",
-    "version": "4.3.1"
-  },
-  "ctime": 1580587641,
-  "expire_in": 504576000,
-  "prev": "c99f66ba0bfa7ff6be736e24691c8007b0db41b6036b7f1e5f9335ab7f3550f4",
-  "seqno": 34,
-  "tag": "signature"
-}
-
-which yields the signature:
-
-hKRib2R5hqhkZXRhY2hlZMOpaGFzaF90eXBlCqNrZXnEIwEg+1hTInDCYaAK4J7z7kew3PdlkrSFFll3Mp4J7ExPyGkKp3BheWxvYWTESpcCIsQgyZ9mugv6f/a+c24kaRyAB7DbQbYDa38eX5M1q381UPTEIH8FtgpzXt/JJxrhAYknW7xL4+K57JBJnbhFpXWAfEH5AgHCo3NpZ8RApEnmCcZApdOTf+XAHRbbgoysAZHfyTHamWC/BEHKuqEf/BlUFSxo6ASa/YC+Y2sMJfW2iRFlP2bs822TyJTBA6hzaWdfdHlwZSCkaGFzaIKkdHlwZQildmFsdWXEINm3yJdAbmbGJd03EnpuKVh2JzkI8WkngbWbAxbbR0MMo3RhZ80CAqd2ZXJzaW9uAQ==
-
-And finally, I am proving ownership of this host by posting or
-appending to this document.
-
-View my publicly-auditable identity here: https://keybase.io/masser
-
-===================================================================
-https://keybase.io/masser
---------------------------------------------------------------------
-
-I hereby claim:
-
-  * I am an admin of https://rauhala.info
-  * I am masser (https://keybase.io/masser) on keybase.
-  * I have a public key ASD7WFMicMJhoArgnvPuR7Dc92WStIUWWXcyngnsTE_IaQo
-
-To do so, I am signing this object:
-
-{
-  "body": {
-    "key": {
-      "eldest_kid": "01202eb5d3b8d2fc63e4bc9c6edefb3a38f1043dfdc44a7268393951fe0ea5214cf00a",
-      "host": "keybase.io",
-      "kid": "0120fb58532270c261a00ae09ef3ee47b0dcf76592b485165977329e09ec4c4fc8690a",
-      "uid": "b01557931e13482e9e646593a64e9119",
-      "username": "masser"
-    },
-    "merkle_root": {
-      "ctime": 1580591326,
-      "hash": "2b1b8c5e3de98e3e80ec4b4c28270066744d5d0982c23e4c13ec97d9311e32996b0cc39ab07f51a2418f833d3f03c0219c7ebd8cdc9c99ac09d3f88d0b6129d1",
-      "hash_meta": "0e85fd563e1159d6c5b32f5c424d4c97101c3a11346a0dad77bdbf043ca4f287",
-      "seqno": 14452336
-    },
-    "service": {
-      "entropy": "7UNm+4us1fZE3TRssgGatBC2",
-      "hostname": "rauhala.info",
-      "protocol": "https:"
-    },
-    "type": "web_service_binding",
-    "version": 2
-  },
-  "client": {
-    "name": "keybase.io go client",
-    "version": "4.3.1"
-  },
-  "ctime": 1580591336,
-  "expire_in": 504576000,
-  "prev": "ed5dd9b2571746743f37dd55f59235bd46d7f7de01a2bafba14b9c0929751aee",
-  "seqno": 35,
-  "tag": "signature"
-}
-
-which yields the signature:
-
-hKRib2R5hqhkZXRhY2hlZMOpaGFzaF90eXBlCqNrZXnEIwEg+1hTInDCYaAK4J7z7kew3PdlkrSFFll3Mp4J7ExPyGkKp3BheWxvYWTESpcCI8Qg7V3ZslcXRnQ/N91V9ZI1vUbX994Borr7oUucCSl1Gu7EIJld9Pai+YxhSvZUIA+ZyzwEEbpy98uEqp975YKAEdz9AgHCo3NpZ8RAtksa9w0UQrwg8dPGEzahht+hY4QKQthbZ/yWuOSmfA3C5E1/KorbIEi+tcy5lkSJqNbZRSqBgpl9zerYw5bbAahzaWdfdHlwZSCkaGFzaIKkdHlwZQildmFsdWXEICy29OKKJc5LUELFLo8kW15N3zex43ussKLFeGLhTDapo3RhZ80CAqd2ZXJzaW9uAQ==
-
-And finally, I am proving ownership of this host by posting or
-appending to this document.
-
-View my publicly-auditable identity here: https://keybase.io/masser
-
-===================================================================================================================================