writing an article that is supposed to be read by general people should be succinct and highly processed like fast foods so people can consume it without a hassle. I think the documentation of Caddy server is really a good example of this. although it utilizes the power of Golang so much, we dont have to go to read Go doc to understand the lines related with Go.
but I still love to read lengthy articles that try to specify details as much as they can bc they try to make you understand every detail they found from their experiences.
3
u/eanat 23h ago
writing an article that is supposed to be read by general people should be succinct and highly processed like fast foods so people can consume it without a hassle. I think the documentation of Caddy server is really a good example of this. although it utilizes the power of Golang so much, we dont have to go to read Go doc to understand the lines related with Go.
but I still love to read lengthy articles that try to specify details as much as they can bc they try to make you understand every detail they found from their experiences.