programming "Pair documenting" might produce higher quality documentation. Over the past two days I spent about 8 hours writing documentation. Was the documentation worth it? Will anyone ever read it? If they do, will it help? When is documentation done? Have
typescript TypeScript constructor parameters with public, private, and protected A class constructor can automatically create and initialize class properties by using parameter property declarations. public class Foo { constructor(public bar: string, private baz: number, protected qux: boolean) {} } That is the equivalent of
git Finding (searching for) things with Git Search file name git ls-files '<pathspec>' git log '<pathspec>' git rev-list --all -- '<pathspec>' Search file content git log -S '&
software-development Architecting Large Scale Software Systems Image by janeb13 at https://pixabay.com/en/europa-sailboat-fs-senator-brockes-1185800/ These are notes on architecting large scale systems. (Is architecting even a word?) The notes came out of a series of recent conversations with
software-development Software Testing Strategies and Canonical Names Note: This is a continuation of a previous post here: http://www.muddlingthru.ca/types-of-software-testing Using canonical test strategies and industry standard names helps because it: facilitates team communication, eases developer on-boarding, and
classic-mistakes The classic mistake of keeping a throwaway prototype In chapter 28 of Rapid Development, McConnel (2014) calls the "throwaway prototype" a software development best practice; he also warns that keeping the throwaway prototype is a classic software development mistake.
software-development How to name boolean returning functions and methods? Introduction This blog post is about how to choose a coding style for boolean returning functions. It represents about 2 hours of research. tl;dr Since there are sound reasons for several options,
goal-setting Some Career-Related Ultimate Goals for 2017 An ultimate goal is a goal that is not necessarily achievable; it is rather a compass north point: where do we want to be, eventually? Writing down ultimate goals has an almost magical