Excellent article, well thought-out! I'd like to stress a lot about justifying choices or explaining why there must be a workaround by providing a Stack Overflow thread of a GitHub issue. This saved me countless times from trying to mess up something believing that I could make it better or fix it.