There seems to be an undercurrent here on dev.to; I've noticed a few posts about documentation, each recognizing that it is important, but searching for better tools and good practice recommendations.
Clearly there is need for some helpful guidance. I'll start writing a more in-depth post, but in the mean time I can point you to some useful resources:
Hi Elsa, That's great! I think it's such an undercurrent because we often come across these problems. This post is not so much on writing my own documentation as it is about an over complicated learning curve for our favorite tools because documentation is conflicting.
Regardless, these resources are a good help though and might help in contributing to better documentation in open source software.
Another thought, would you think it to be okay to ask someone who blogged about a topic to update their article or add a note that something is out of date?
I think its okay to ask someone to update an article they wrote. Some tools/processes change quickly, while others are very stable. Sometimes (if the original author has moved on from a particular tool) it can be useful to write your own post on how transition a project from an old tool to a new one.
For further actions, you may consider blocking this person and/or reporting abuse
We're a place where coders share, stay up-to-date and grow their careers.
There seems to be an undercurrent here on dev.to; I've noticed a few posts about documentation, each recognizing that it is important, but searching for better tools and good practice recommendations.
Clearly there is need for some helpful guidance. I'll start writing a more in-depth post, but in the mean time I can point you to some useful resources:
Hi Elsa, That's great! I think it's such an undercurrent because we often come across these problems. This post is not so much on writing my own documentation as it is about an over complicated learning curve for our favorite tools because documentation is conflicting.
Regardless, these resources are a good help though and might help in contributing to better documentation in open source software.
Another thought, would you think it to be okay to ask someone who blogged about a topic to update their article or add a note that something is out of date?
I think its okay to ask someone to update an article they wrote. Some tools/processes change quickly, while others are very stable. Sometimes (if the original author has moved on from a particular tool) it can be useful to write your own post on how transition a project from an old tool to a new one.