Skip to content
This repository has been archived by the owner on Dec 22, 2021. It is now read-only.

Create docs-decision-tree.md #14

Merged
merged 1 commit into from Feb 20, 2019
Merged

Create docs-decision-tree.md #14

merged 1 commit into from Feb 20, 2019

Conversation

shannonbux
Copy link
Contributor

Will be accepting comments, discussion, and feedback until October 31st!

@shannonbux shannonbux self-assigned this Oct 9, 2018
@calcsam
Copy link

calcsam commented Oct 9, 2018

Awesome! Here are some screenshots of the Whimsical chart for reference:

image

image

image

image


## How will we drive adoption?

Test it during Hacktoberfest. For the time being, that's good enough because @amberley and I are already getting tagged as @docsteam, so we can test the decision tree anytime we get tagged.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Any feedback from Hacktoberfest now that it's been over for a while?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would say the things that went well:

  • the code-owners @gatsbyjs/docs team did a great job gathering all docs-related issues into one spot since it tagged the team automatically for anything in /docs/ /tutorial/ or 'doc-links.yml' or 'tutorial-links.yml'
  • The OSS team has done a good job merging things that don't need my specialization - for example, without waiting for docs team approval, they merge stuff that makes docs more accurate, more up-to-date, more in line with the style guide. I like this. Don't know if they like it...:)

The things that are still remaining issues imo:

  • I don't know how to change code owners notifications and don't know who owns it or how to look at it, so I'm not sure if my request that I only be notified about changes to 'doc-links.yml' and 'tutorial-links.yml' instead of all docs changes has been accomplished
  • I also wanted to be notified about any docs being deleted or added to /docs/, not sure if it's possible to automate this.
  • Sometimes, really big changes to the docs need a technical review after I do a docs review, and I don't know who to assign or ping.

@shannonbux shannonbux merged commit 87ea8eb into master Feb 20, 2019
@jlengstorf jlengstorf deleted the shannonbux-patch-1 branch February 28, 2019 16:16
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants