Skip to content

docs: add missing guides, examples, images to CODEOWNERS - #28597

Closed
gkalpak wants to merge 3 commits into
angular:masterfrom
gkalpak:docs-update-codeowners
Closed

gkalpak wants to merge 3 commits into
angular:masterfrom
gkalpak:docs-update-codeowners

Conversation

@gkalpak

@gkalpak gkalpak commented Feb 7, 2019

Copy link
Copy Markdown
Member

Some guides/examples/images from aio/content/ did not have owners (in .github/CODEOWNERS) and fell back to the default owners.
This PR adds owners for all guides/examples/images.

@gkalpak
gkalpak requested a review from IgorMinar as a code owner February 7, 2019 16:22
@gkalpak
gkalpak requested review from a team February 7, 2019 16:22
@ngbot ngbot Bot added this to the needsTriage milestone Feb 7, 2019
@gkalpak gkalpak added action: review The PR is still awaiting reviews from at least one requested reviewer comp: docs-infra target: patch This PR is targeted for the next patch release labels Feb 7, 2019
Comment thread .github/CODEOWNERS Outdated

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

cheatsheet should go under core.

glossary and public api should go into the public_api group at the bottom

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I assume you meant "glossary and styleguide" 😃

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I think of glossary and architecture docs as part of docs-intro, similar to getting started and tutorial. I suppose glossary could be public-api, but architecture is definitely similar to other intro materials.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I think that all three of these should go under public api as they are the most visible terminology definitions, recommendations and "style" guides.

Comment thread .github/CODEOWNERS Outdated

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

let's move all of these into the docs-infra group

@IgorMinar IgorMinar left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

responding to questions...

Comment thread .github/CODEOWNERS Outdated

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

cheatsheet should go under core.

glossary and public api should go into the public_api group at the bottom

Comment thread .github/CODEOWNERS Outdated

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

let's move all of these into the docs-infra group

@IgorMinar IgorMinar added action: cleanup The PR is in need of cleanup, either due to needing a rebase or in response to comments from reviews and removed action: review The PR is still awaiting reviews from at least one requested reviewer labels Feb 8, 2019
@gkalpak
gkalpak force-pushed the docs-update-codeowners branch from 7027a02 to 1853700 Compare February 12, 2019 07:57
Comment thread .github/CODEOWNERS Outdated

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

@IgorMinar, what about these ones?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

It would be good to have a codeowners group(s) that alexE and hans can approve, for libraries, schematics, CLI overview page.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

libraries should likely be a separate category with a separate team owning it - the owners should be some folks on the tooling team and me. @alexeagle can give you the list of tooling team ppl

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

and yesk, I previously said that we should reuse ngtools group, but now I'm thinking that reviewing library docs changes requires a very specific knowledge, so a custom group would be better.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Hmm, I think it's probably @hansl, @mgechev, @alan-agius4

@gkalpak gkalpak added action: review The PR is still awaiting reviews from at least one requested reviewer and removed action: cleanup The PR is in need of cleanup, either due to needing a rebase or in response to comments from reviews labels Feb 12, 2019
@gkalpak

gkalpak commented Feb 12, 2019

Copy link
Copy Markdown
Member Author

(Note: The CI failure in test_ivy_aot is inherited from master and that job's outcome is not affected by this PR.)

@gkalpak gkalpak mentioned this pull request Feb 27, 2019
3 of 14 tasks

@IgorMinar IgorMinar left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

the rest looks good.

please resolve comments and remove all TODOs and ??? and send for merge.

Comment thread .github/CODEOWNERS Outdated

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I think that all three of these should go under public api as they are the most visible terminology definitions, recommendations and "style" guides.

Comment thread .github/CODEOWNERS Outdated

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

libraries should likely be a separate category with a separate team owning it - the owners should be some folks on the tooling team and me. @alexeagle can give you the list of tooling team ppl

@gkalpak
gkalpak force-pushed the docs-update-codeowners branch 3 times, most recently from caea04a to cb61558 Compare February 28, 2019 17:09
@gkalpak

gkalpak commented Feb 28, 2019

Copy link
Copy Markdown
Member Author

I made all necessary changes. @IgorMinar, you need to create the fw-docs-libraries GitHub group.

@gkalpak
gkalpak force-pushed the docs-update-codeowners branch from cb61558 to 3fe3661 Compare March 7, 2019 20:15
@gkalpak

gkalpak commented Mar 7, 2019

Copy link
Copy Markdown
Member Author

I found out I can create the GitHub team myself, so I created tools-docs-libraries.

@gkalpak gkalpak added action: merge The PR is ready for merge by the caretaker merge: caretaker note Alert the caretaker performing the merge to check the PR for an out of normal action needed or note labels Mar 7, 2019
@gkalpak gkalpak removed the action: review The PR is still awaiting reviews from at least one requested reviewer label Mar 7, 2019
@gkalpak

gkalpak commented Mar 7, 2019

Copy link
Copy Markdown
Member Author

merge-assistance: @IgorMinar said I can send for merge (#28597 (review)).

@kara kara added target: major This PR is targeted for the next major release and removed target: patch This PR is targeted for the next patch release labels Mar 7, 2019
@kara

kara commented Mar 7, 2019 •

Copy link
Copy Markdown
Contributor

Note: The changes aren't applying cleanly to patch, so merging it into master now, and George has agreed to create another PR against the patch branch that resolves the conflicts.

gkalpak added 3 commits March 7, 2019 13:12
… have owners

It is useful for manually checking that all guides/examples/images have
owners in `.github/CODEOWNERS`, but is not used for automatic
verification (e.g. on CI) for now.
@kara
kara force-pushed the docs-update-codeowners branch from 3fe3661 to 652b911 Compare March 7, 2019 21:14
@kara kara closed this in 4f2773e Mar 7, 2019
kara pushed a commit that referenced this pull request Mar 7, 2019
kara pushed a commit that referenced this pull request Mar 7, 2019
… have owners (#28597)

It is useful for manually checking that all guides/examples/images have
owners in `.github/CODEOWNERS`, but is not used for automatic
verification (e.g. on CI) for now.

PR Close #28597
@gkalpak
gkalpak deleted the docs-update-codeowners branch March 7, 2019 21:26
wKoza pushed a commit to wKoza/angular that referenced this pull request Apr 17, 2019
wKoza pushed a commit to wKoza/angular that referenced this pull request Apr 17, 2019
wKoza pushed a commit to wKoza/angular that referenced this pull request Apr 17, 2019
… have owners (angular#28597)

It is useful for manually checking that all guides/examples/images have
owners in `.github/CODEOWNERS`, but is not used for automatic
verification (e.g. on CI) for now.

PR Close angular#28597
@angular-automatic-lock-bot

Copy link
Copy Markdown

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

This action has been performed automatically by a bot.

@angular-automatic-lock-bot angular-automatic-lock-bot Bot locked and limited conversation to collaborators Sep 14, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

action: merge The PR is ready for merge by the caretaker cla: yes merge: caretaker note Alert the caretaker performing the merge to check the PR for an out of normal action needed or note target: major This PR is targeted for the next major release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants