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

docs: clean up types and add API docs site #199

Merged
merged 3 commits into from
Jul 13, 2024
Merged

docs: clean up types and add API docs site #199

merged 3 commits into from
Jul 13, 2024

Conversation

erickzhao
Copy link
Member

Similar to electron/osx-sign#320 but for notarize.

Significant changes:

  • Removal of NotarizeStapleOptions which is functionally identical to NotaryToolNotarizeAppOptions.
  • Added details on keychain credential authentication and debugging notarization credentials
  • Added more usage examples with each authentication strategy

See preview: https://erickzhao.github.io/notarize/

@erickzhao erickzhao requested a review from a team as a code owner June 6, 2024 21:56
@erickzhao erickzhao changed the title docs: generate documentation website docs: clean up types and add API docs site Jun 6, 2024
Copy link
Member

@yangannyx yangannyx left a comment

Choose a reason for hiding this comment

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

Looking great overall! Just had a few questions based on what I'm seeing in the preview link


If you are using Electron 11 or below, you must add the `com.apple.security.cs.allow-unsigned-executable-memory` entitlement too.
When using version 12+, this entitlement should not be applied as it increases your app's attack surface.
> [!NOTE]
Copy link
Member

Choose a reason for hiding this comment

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

What is the purpose of the [!NOTE] here? Is it suppose to style the block below? I think it looks a little strange in the preview https://erickzhao.github.io/notarize/#md:prerequisites

Copy link
Member Author

Choose a reason for hiding this comment

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

It stylizes the GitHub README (https://github.com/orgs/community/discussions/16925)

TypeDoc doesn't support it, but I figured one is better than none.

```

Another option is that you can add a new keychain item using either the Keychain Access app or from the command line using the `security` utility:
> [!IMPORTANT]
Copy link
Member

Choose a reason for hiding this comment

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

Similar question as above - seems to render funny in the preview

@@ -9,102 +9,174 @@ Electron Notarize
## Installation

```bash
# npm
npm install @electron/notarize --save-dev
Copy link
Member

Choose a reason for hiding this comment

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

Just curious, why was the yarn command removed?

Copy link
Member Author

Choose a reason for hiding this comment

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

We did this recently for Forge but with the fragmentation of the JavaScript package manager ecosystem (npm, yarn 1, yarn 2+, pnpm, bun), it's easier for us to just keep the default command and for users who use alternative package managers to do the translation on their end instead.

Comment on lines +160 to +161
When notarizing your application, you may run into issues with validating your notarization
credentials.
Copy link
Member

Choose a reason for hiding this comment

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

Is the preview link https://erickzhao.github.io/notarize/#md:prerequisites stale? I don't see this text and the text below in the preview

Copy link
Member Author

Choose a reason for hiding this comment

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

Oh, it is, sorry. I generated it against the original commit in this PR but added this text in 88b0302.

@erickzhao erickzhao requested a review from yangannyx July 12, 2024 23:57
Copy link
Member

@yangannyx yangannyx left a comment

Choose a reason for hiding this comment

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

LGTM!

@erickzhao erickzhao merged commit a38ba02 into main Jul 13, 2024
3 checks passed
@erickzhao erickzhao deleted the docs/typedoc branch July 13, 2024 00:31
Copy link

🎉 This PR is included in version 2.4.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants