Skip to main content
replaced http://stackoverflow.com/ with https://stackoverflow.com/
Source Link

Being as it is my first post, I wanted to take the opportunity to introduce myself. I am Vasudha, the new product manager for SO Documentation. Am super thrilled to be here and I can’t wait to work with all of you to get Documentation to the right place!

The question you raise is a good one and one that we have been talking about on the team as well. We recently went through an extensive round of user research where we interviewed both users (with different levels of activity on Docs) and non-users of the product. A bunch of patterns emerged and we identified the top barriers and motivations to the use of Documentation. As part of that, the need for features that enable better attributing, linking and referencing of existing documentation, came to light. While SO Docs is example focused, and aims to provide users with more ways to apply the said topic; providing context, definition and enough information to make the topic clear and complete is a must.

The lack of such attribution tools have manifested in other ways - one of them being plagiarism, since some of our users that really like the content on a different site, choose to paste it onto SO.

We have also seen some good ways our community has gotten around this hurdle -

  1. enter image description hereenter image description here

enter image description hereenter image description here 3. enter image description hereenter image description here

Until we make attribution and linking officially available within the product, I’d be a proponent of the above approach.

Without a doubt, we still stand true to what Kevin Montrose mentioned in our first post to the community about Docs -

What should be documented?

Anything where we can actually make it better. If a project already has awesome documentation that's easy to search and cite, then there's no need to duplicate it on Stack Overflow. We're interested in fixing what's broken with documentation, not just moving them onto Stack Overflow.

We realize we need to make it easy for the community to be easily able to point to such references. And that’s exactly what we intend to do!

Being as it is my first post, I wanted to take the opportunity to introduce myself. I am Vasudha, the new product manager for SO Documentation. Am super thrilled to be here and I can’t wait to work with all of you to get Documentation to the right place!

The question you raise is a good one and one that we have been talking about on the team as well. We recently went through an extensive round of user research where we interviewed both users (with different levels of activity on Docs) and non-users of the product. A bunch of patterns emerged and we identified the top barriers and motivations to the use of Documentation. As part of that, the need for features that enable better attributing, linking and referencing of existing documentation, came to light. While SO Docs is example focused, and aims to provide users with more ways to apply the said topic; providing context, definition and enough information to make the topic clear and complete is a must.

The lack of such attribution tools have manifested in other ways - one of them being plagiarism, since some of our users that really like the content on a different site, choose to paste it onto SO.

We have also seen some good ways our community has gotten around this hurdle -

  1. enter image description here

enter image description here 3. enter image description here

Until we make attribution and linking officially available within the product, I’d be a proponent of the above approach.

Without a doubt, we still stand true to what Kevin Montrose mentioned in our first post to the community about Docs -

What should be documented?

Anything where we can actually make it better. If a project already has awesome documentation that's easy to search and cite, then there's no need to duplicate it on Stack Overflow. We're interested in fixing what's broken with documentation, not just moving them onto Stack Overflow.

We realize we need to make it easy for the community to be easily able to point to such references. And that’s exactly what we intend to do!

Being as it is my first post, I wanted to take the opportunity to introduce myself. I am Vasudha, the new product manager for SO Documentation. Am super thrilled to be here and I can’t wait to work with all of you to get Documentation to the right place!

The question you raise is a good one and one that we have been talking about on the team as well. We recently went through an extensive round of user research where we interviewed both users (with different levels of activity on Docs) and non-users of the product. A bunch of patterns emerged and we identified the top barriers and motivations to the use of Documentation. As part of that, the need for features that enable better attributing, linking and referencing of existing documentation, came to light. While SO Docs is example focused, and aims to provide users with more ways to apply the said topic; providing context, definition and enough information to make the topic clear and complete is a must.

The lack of such attribution tools have manifested in other ways - one of them being plagiarism, since some of our users that really like the content on a different site, choose to paste it onto SO.

We have also seen some good ways our community has gotten around this hurdle -

  1. enter image description here

enter image description here 3. enter image description here

Until we make attribution and linking officially available within the product, I’d be a proponent of the above approach.

Without a doubt, we still stand true to what Kevin Montrose mentioned in our first post to the community about Docs -

What should be documented?

Anything where we can actually make it better. If a project already has awesome documentation that's easy to search and cite, then there's no need to duplicate it on Stack Overflow. We're interested in fixing what's broken with documentation, not just moving them onto Stack Overflow.

We realize we need to make it easy for the community to be easily able to point to such references. And that’s exactly what we intend to do!

Source Link

Being as it is my first post, I wanted to take the opportunity to introduce myself. I am Vasudha, the new product manager for SO Documentation. Am super thrilled to be here and I can’t wait to work with all of you to get Documentation to the right place!

The question you raise is a good one and one that we have been talking about on the team as well. We recently went through an extensive round of user research where we interviewed both users (with different levels of activity on Docs) and non-users of the product. A bunch of patterns emerged and we identified the top barriers and motivations to the use of Documentation. As part of that, the need for features that enable better attributing, linking and referencing of existing documentation, came to light. While SO Docs is example focused, and aims to provide users with more ways to apply the said topic; providing context, definition and enough information to make the topic clear and complete is a must.

The lack of such attribution tools have manifested in other ways - one of them being plagiarism, since some of our users that really like the content on a different site, choose to paste it onto SO.

We have also seen some good ways our community has gotten around this hurdle -

  1. enter image description here

enter image description here 3. enter image description here

Until we make attribution and linking officially available within the product, I’d be a proponent of the above approach.

Without a doubt, we still stand true to what Kevin Montrose mentioned in our first post to the community about Docs -

What should be documented?

Anything where we can actually make it better. If a project already has awesome documentation that's easy to search and cite, then there's no need to duplicate it on Stack Overflow. We're interested in fixing what's broken with documentation, not just moving them onto Stack Overflow.

We realize we need to make it easy for the community to be easily able to point to such references. And that’s exactly what we intend to do!