I also don’t what fellow developers to go through the same struggles when solving a similar problem and fall for the same misleading information they may find online, I feel I should document my frustration and solutions.
Also for self promoting
Besides that, it has also proven to be a valuable lead-generation tool for freelance work.
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/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.
Also I have a lot of trouble actually remembering things and keeping my projects straight. By writing blog posts, even if I don't publish them, I can keep things straight.
I also needed to use picsofbread.com for something.