Blogging, but really marketing in general, thought me to ask "what do I want to say?" and "to whom am I talking?" To an extreme this is also important in the c

Blogging, but really marketing in general, thought me to ask "what do I want to say?" and "to whom am I talking?" To an extreme this is also important in the code, because you can get the most clever algorithm or implementation or optimizatiton, but if your code should be maintained by someone else, you'd better keep it clear over clever. In short, write code that others can understand and modify. More generally, with code we have comments, commit messages, readme and sometime even documentation. This is an example of how, at a certain point in time, we reviewed our README. From a confusing list of instructions, it's now a clear how to: https://github.com/solokeys/solo/commit/bbc61d5743b45d62f7e2cbd5f0d605a17a890a03?short_path=04c6e90#diff-04c6e90faac2675aa89e2176d2eec7d8 https://github.com/solokeys/solo/commit/bbc61d5743b45d62f7e2... - What is this? A security key, with call to action (you can get one) - First FAQ: Security - First User / Use case: Hacker who wants to personalize his key - Advanced User: Developer who wants to contribute - More docs - More bla bla - Call to action again (you can get one) As you can see this is the classical structure of any blog post / marketing page.