Package-maintenance: draft documentation promotion

Created on 16 Jun 2020  路  6Comments  路  Source: nodejs/package-maintenance

We have a number of docs in draft status, but not sure what is left or needed. They should probably all be reviewed and if complete "enough" should probably be at least moved into the top level docs folder.

This is a top level tracking item to promote them all

  • [ ] [Continuous Integration / Delivery](https://github.com/nodejs/package-maintenance/blob/master/docs/drafts/PUBLISH-GUIDELINES.md) - #340 (assigned)
  • [ ] [Security](https://github.com/nodejs/package-maintenance/blob/master/docs/drafts/security-guidelines.md) - #343
  • [x] [Testing](https://github.com/nodejs/package-maintenance/blob/master/docs/drafts/testing-guidelines.md) - #344
  • [ ] [Publishing Guidelines](https://github.com/nodejs/package-maintenance/blob/master/docs/drafts/publish-guidelines.md) - #345
  • [x] [Package Support](https://github.com/nodejs/package-maintenance/blob/master/docs/drafts/package-support.md) - #346
  • [x] Tools - #347 (marked as invalid)
  • [ ] Dependency Management - #280 (assigned)
  • [ ] [Deprecate Guidelines](https://github.com/nodejs/package-maintenance/blob/main/docs/drafts/DEPRECATE-GUIDELINES.md) - #431 (draft)

Note: they should also have the "draft" status removed from their listing in the Table of Contents.

article good first issue help wanted package-maintenance-agenda

Most helpful comment

@thescientist13 the testing doc is looking good and there is only one other re-review by @bnb to come in. I wanted to make a start on the CI/CD document. The feedback is we need real examples and so I have been working, as a part of the expressJS triage team, to learn how to carry out full CI/CD on the GitHub actions platform. I have been working in an integration test repo so that we have some hard examples of not just regular unit test and lint operations but we have npm and docker image publication then integration tests using those images.

All 6 comments

@thescientist13 thank you Owen, this does seem like something that I have time for. I'll look at the testing draft by @Eomm over the next week, make comments and get back.

@thescientist13 I think the testing document is going well and we are only waiting on a few more reviews. It is a basic document but there are quite distinct schools of thought about testing.
I would like to move onto the CI/CD document. @dominykas mentioned in the testing document review that we need real world methodologies of how and where we can do CI/CD for open source. I agree and I'll link the testing document to the CI/CD document once we get it written.

For myself I do not know quite enough to start this yet and want to talk in the next package maintenance meeting. What we need are a bunch of projects in opensource that do this so we have concrete examples.

Hey @ghinks , and sounds good to me. Maybe we should add the agenda label to #340 and then we can discuss it on the call this week? Happy to help contribute ideas and topics for the document as well. 馃憤

@thescientist13 the testing doc is looking good and there is only one other re-review by @bnb to come in. I wanted to make a start on the CI/CD document. The feedback is we need real examples and so I have been working, as a part of the expressJS triage team, to learn how to carry out full CI/CD on the GitHub actions platform. I have been working in an integration test repo so that we have some hard examples of not just regular unit test and lint operations but we have npm and docker image publication then integration tests using those images.

should the deprecation guidelines also be part of the promotion list?

@lholmquist that
Oh yes, good call. I suppose an issue should be made for that one as well... so done and added! ( #431)

Was this page helpful?
0 / 5 - 0 ratings

Related issues

mhdawson picture mhdawson  路  31Comments

Eomm picture Eomm  路  35Comments

Eomm picture Eomm  路  54Comments

Eomm picture Eomm  路  36Comments

jchip picture jchip  路  54Comments