-
Notifications
You must be signed in to change notification settings - Fork 193
Create third-party-services-documentation-policy.md #1482
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
base: main
Are you sure you want to change the base?
Create third-party-services-documentation-policy.md #1482
Conversation
This is the proposed Third Party Services Documentation Policy discussed in openjs-foundation#1425.
This comment was marked as off-topic.
This comment was marked as off-topic.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
|
||
## **2. Ensure the service registry is accessible to the OpenJS Foundation** {#ensure-the-service-registry-is-accessible-to-the-openjs-foundation} | ||
|
||
Projects have two options on how to approach storing and granting OpenJS access to their service registry file. Regardless of the approach, the service registry file must be accessible to the OpenJS Executive Director Robin Ginn ([@rginn](https://www.github.com/rginn), [[email protected]](mailto:[email protected])) and OpenJS Director of Program Management Ben Sternthal ([@bensternthal](https://www.github.com/bensternthal), [[email protected]](mailto:[email protected])). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not that I foresee any changes here... 😉 But should we include concrete people in such documents? If anyone decides to step down, we may have a lot of docs to update.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Agreed. This has come up in different places. What about we have a list of staff members / functions in the repo and just reference those from here?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I agree with @tobie's suggestion.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Could aliases be used here too? Such as operations@
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'll defer to @bensternthal on this since he and @rginn will be the ones operationalizing this.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@ovflowd Brings up a good point, an alias would save us a lot of effort if/when folks leave. I'd suggest we start with that and handle edge cases when they pop up.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ok I'll update this and the npm continuity policy use the aliases instead.
Co-authored-by: Michał Gołębiowski-Owczarek <[email protected]> Signed-off-by: rudd <[email protected]>
Co-authored-by: Mohammed Keyvanzadeh <[email protected]> Signed-off-by: rudd <[email protected]>
Co-authored-by: Mohammed Keyvanzadeh <[email protected]> Signed-off-by: rudd <[email protected]>
Co-authored-by: Mohammed Keyvanzadeh <[email protected]> Signed-off-by: rudd <[email protected]>
Co-authored-by: Mohammed Keyvanzadeh <[email protected]> Signed-off-by: rudd <[email protected]>
Co-authored-by: Mohammed Keyvanzadeh <[email protected]> Signed-off-by: rudd <[email protected]>
Co-authored-by: Mohammed Keyvanzadeh <[email protected]> Signed-off-by: rudd <[email protected]>
Signed-off-by: rudd <[email protected]>
Signed-off-by: rudd <[email protected]>
Signed-off-by: rudd <[email protected]>
Signed-off-by: rudd <[email protected]>
Signed-off-by: rudd <[email protected]>
Resolved all the comments and feedback, lmk if I missed anything. |
Everything is updated based on feedback - check things out and if we're good to go then we're finished! |
Notes from July 8 CPC call:
|
This is the proposed Third Party Services Documentation Policy discussed in #1425.