Skip to content

feat: overhaul docs / publish to npm#75

Merged
mnahkies merged 14 commits into
mainfrom
mn/feat/overhaul-docs-for-publishing
Oct 1, 2023
Merged

feat: overhaul docs / publish to npm#75
mnahkies merged 14 commits into
mainfrom
mn/feat/overhaul-docs-for-publishing

Conversation

@mnahkies
Copy link
Copy Markdown
Owner

@mnahkies mnahkies commented Sep 17, 2023

  • Add a clean step
  • Specify the files to publish
  • Add scripts for publishing locally
    • Add commented steps for publishing in GH actions. Uncertain of security concerns around forks / PR's gaining access to secrets so leaving this out for now.
  • Update package metadata
  • Rework the readmes and split out contributing and architecture guides

Alpha Published
First alpha versions have been published to npm here: https://www.npmjs.com/package/@nahkies/openapi-code-generator

Testing notes
Publishing scripts have been tested locally using my self-hosted Verdaccio instance and all appears fine.

The markdown links are a bit broken, but I'm fairly sure that's Verdaccio not me.

Additionally manually inspected the contents of the tarball for each package and there are no missing or extraneous files.

image

@mnahkies mnahkies force-pushed the mn/feat/overhaul-docs-for-publishing branch from 014bfe8 to 90ad90d Compare September 23, 2023 09:42
@mnahkies mnahkies force-pushed the mn/feat/overhaul-docs-for-publishing branch from 90ad90d to 3b8cefa Compare September 23, 2023 09:59
@mnahkies mnahkies force-pushed the mn/feat/overhaul-docs-for-publishing branch 3 times, most recently from b227f0c to a6cba44 Compare September 23, 2023 12:24
@mnahkies mnahkies force-pushed the mn/feat/overhaul-docs-for-publishing branch from a6cba44 to f6dabae Compare September 23, 2023 12:26
@mnahkies mnahkies marked this pull request as ready for review September 23, 2023 12:32
@mnahkies mnahkies merged commit f9386ab into main Oct 1, 2023
@mnahkies mnahkies deleted the mn/feat/overhaul-docs-for-publishing branch October 1, 2023 09:09
Copy link
Copy Markdown
Collaborator

@asfaltboy asfaltboy left a comment

Choose a reason for hiding this comment

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

forgot to submit the review a while back

nothing particular interesting here, just takes a loaded document and validates it against
the openapi3 specification in json schema format.

Useful for detecting emission errors due to bad input rather than bugs in the code generation.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Did you mean "omission"? Can also just say:

Suggested change
Useful for detecting emission errors due to bad input rather than bugs in the code generation.
Useful for detecting errors due to bad input rather than bugs in the code generation.

Copy link
Copy Markdown
Collaborator

@asfaltboy asfaltboy Jan 27, 2024

Choose a reason for hiding this comment

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

addressed in 6fa5e50

Comment thread .github/workflows/ci.yml
- name: Check for uncommitted changes
run: ./scripts/assert-clean-working-directory.sh

# TODO: figure out how to do this safely, eg: no risk of external contributors exfiltrating publish secret.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I think secrets are now obfuscated in logs (see below), and without access to the settings I can't access it.

image

You can try and add some dummy values and enable this (even if auth fails) and I can tell you what I can see and what I can't

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.

2 participants