Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: adding admin policy docs #443

Merged
merged 26 commits into from
Mar 13, 2020
Merged

Conversation

joesepi
Copy link
Member

@joesepi joesepi commented Jan 9, 2020

Closes: #185

Adding docs based on Node.js version:

@joesepi joesepi marked this pull request as ready for review February 25, 2020 19:38
WORKING_GROUPS.md Outdated Show resolved Hide resolved
WORKING_GROUPS.md Outdated Show resolved Hide resolved
Copy link
Member

@obensource obensource left a comment

Choose a reason for hiding this comment

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

Added a couple questions and edit suggestions for you, I also have some edits ready to be PR'd into your working branch @joesepi – if you can give me edit permissions to your fork. 🎉

Thanks!

WORKING_GROUPS.md Outdated Show resolved Hide resolved
GITHUB_ORG_MANGEMENT_POLICY.md Outdated Show resolved Hide resolved

A Working Group's charter can be revoked either by consent of the Working
Group's members or by a CPC vote. Once revoked, any future work that arises
becomes the responsibility of the CPC.
Copy link
Contributor

Choose a reason for hiding this comment

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

On revocation, should Github projects related to the WG's work be archived unless WG members request otherwise and the CPC agrees?

It seems that doing so by default might help keep the organization project list manageable.

Copy link
Member

Choose a reason for hiding this comment

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

I agree, this should at least enforce that the project list stays manageable. If the CPC is very dependent on the WG's projects, the transfer of responsibility will likely already be well known during the time of revocation anyway. 👍

Copy link
Member Author

Choose a reason for hiding this comment

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

I say let's not be prescriptive and see if this needs to be optimized. It has been working in the Node.js space for some time as is. Thanks.

WORKING_GROUPS.md Outdated Show resolved Hide resolved
WORKING_GROUPS.md Show resolved Hide resolved
@mikesamuel
Copy link
Contributor

Fyi, I did some link and formatting cleanup to try and fix the CI problems in joesepi#1

WORKING_GROUPS.md Outdated Show resolved Hide resolved
WORKING_GROUPS.md Outdated Show resolved Hide resolved
transfer-repo-into-org.md Outdated Show resolved Hide resolved
transfer-repo-into-org.md Outdated Show resolved Hide resolved
* Cleanup named links

There were a number of named links at the bottom that pointed to Node.js equivalents.

Replaced inline URLs with named links, cleaned up the named links to separate them from the document text, and got rid of redundant named links.

* Update transfer-repo-into-org.md

* Cleanup links in GOVERNANCE.md

This seeks to fix the Travis CI warning, and increases consistency among the links to various parts of the CPC charter and project README.
obensource added a commit to joesepi/cross-project-council that referenced this pull request Mar 4, 2020
Updating the admin docs for readability and to address concerns raised by CPC members in [CPC openjs-foundation#443](openjs-foundation#443).
* Update admin docs for readability

Updating the admin docs for readability and to address concerns raised by CPC members in [CPC openjs-foundation#443](openjs-foundation#443).

* update admin docs

* paragraph consistency

* paragraph consistency
WORKING_GROUPS.md Outdated Show resolved Hide resolved
WORKING_GROUPS.md Outdated Show resolved Hide resolved
WORKING_GROUPS.md Outdated Show resolved Hide resolved
WORKING_GROUPS.md Outdated Show resolved Hide resolved
Copy link
Member

@obensource obensource left a comment

Choose a reason for hiding this comment

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

Fix: broken links

transfer-repo-into-org.md Outdated Show resolved Hide resolved
transfer-repo-into-org.md Outdated Show resolved Hide resolved
transfer-repo-into-org.md Outdated Show resolved Hide resolved
transfer-repo-into-org.md Outdated Show resolved Hide resolved
transfer-repo-into-org.md Outdated Show resolved Hide resolved
transfer-repo-into-org.md Outdated Show resolved Hide resolved
transfer-repo-into-org.md Outdated Show resolved Hide resolved
@obensource
Copy link
Member

Sorry for all the noise. :P I won't do fixes via the web interface next time. 🙏

transfer-repo-into-org.md Outdated Show resolved Hide resolved
Copy link
Member

@mhdawson mhdawson left a comment

Choose a reason for hiding this comment

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

LGTM once my last comment about the foundation npm account is addressed.

@obensource
Copy link
Member

@mhdawson thank you for your input! 🙏 Your concern about the foundation npm account has been addressed. 🚀

@mhdawson
Copy link
Member

mhdawson commented Mar 4, 2020

@obensource thanks, looks ready to land to me.

Copy link
Member

@mcollina mcollina left a comment

Choose a reason for hiding this comment

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

lgtm

Copy link
Contributor

@kborchers kborchers left a comment

Choose a reason for hiding this comment

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

LGTM

@joesepi
Copy link
Member Author

joesepi commented Mar 9, 2020

Some changes from @obensource touch the GOVERNANCE.md file, but they are not meaningful changes, only some link cleanup.

@joesepi joesepi merged commit d7f97ef into openjs-foundation:master Mar 13, 2020
infogsrhinoip added a commit to infogsrhinoip/cross-project-council that referenced this pull request Aug 14, 2024
* adding org mgmt files still need work

* gh org mgmt policy update

* working groups doc

* Cleanup named links (#1)

* Cleanup named links

There were a number of named links at the bottom that pointed to Node.js equivalents.

Replaced inline URLs with named links, cleaned up the named links to separate them from the document text, and got rid of redundant named links.

* Update transfer-repo-into-org.md

* Cleanup links in GOVERNANCE.md

This seeks to fix the Travis CI warning, and increases consistency among the links to various parts of the CPC charter and project README.

* Update admin docs for readability (#2)

* Update admin docs for readability

Updating the admin docs for readability and to address concerns raised by CPC members in [CPC #443](openjs-foundation/cross-project-council#443).

* update admin docs

* paragraph consistency

* paragraph consistency

* paragraph consistency

* paragraph consistency

* paragraph consistency

* paragraph consistency

* paragraph consistency

* Update transfer-repo-into-org.md

Co-Authored-By: Michael Dawson <michael_dawson@ca.ibm.com>

* Update WORKING_GROUPS.md

* appease linter

* Update WORKING_GROUPS.md

* consensus seeking model link

* Fix: broken links

* Fix: broken links

* Fix: broken links

* Fix: broken links

* Fix: broken links

* Fix: broken links

* Fix: broken links

* Fix: broken links

* Update transfer-repo-into-org.md

* Updates from PR review

Co-authored-by: Ben Michel <ben@obensource.com>
Co-authored-by: Michael Dawson <michael_dawson@ca.ibm.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add admin policy docs
7 participants