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: improve types #288

Merged
merged 5 commits into from
Jun 21, 2024
Merged

docs: improve types #288

merged 5 commits into from
Jun 21, 2024

Conversation

erickzhao
Copy link
Member

@erickzhao erickzhao commented Jun 11, 2024

Cleanup of our API documentation for @electron/get.

Notable changes:

  • Extracted ElectronGenericArtifactDetails out of ElectronPlatformArtifactDetailsWithDefaults.
  • Typedoc upgrade requires Node.js 16 (can revert if we don't want this)

Other work is mostly categorizing, expanding on existing comments, and hiding internal types.

@erickzhao erickzhao marked this pull request as ready for review June 11, 2024 02:21
@erickzhao erickzhao requested a review from a team as a code owner June 11, 2024 02:21
@erickzhao erickzhao marked this pull request as draft June 11, 2024 02:22
.vscode/settings.json Show resolved Hide resolved
package.json Outdated Show resolved Hide resolved
*/
export async function downloadArtifact(
_artifactDetails: ElectronPlatformArtifactDetailsWithDefaults,
artifactDetails: ElectronPlatformArtifactDetailsWithDefaults | ElectronGenericArtifactDetails,
Copy link
Member Author

Choose a reason for hiding this comment

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

Doesn't make sense to have the function parameter start with _ so I changed the variable naming around.


return await cache.putFileInCache(url, tempDownloadPath, fileName);
});
}

/**
* Downloads a specific version of Electron and returns an absolute path to a
* Downloads the Electron binary for a specific version and returns an absolute path to a
* ZIP file.
Copy link
Member Author

Choose a reason for hiding this comment

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

Technically, we have some non-ZIP artifacts too as well? such as SHASUM256.txt

@erickzhao erickzhao changed the title docs: improve types and such docs: improve types Jun 11, 2024
@erickzhao erickzhao marked this pull request as ready for review June 11, 2024 16:04
@erickzhao erickzhao force-pushed the typedoc-improvements branch 2 times, most recently from 66af0cc to 8e3a343 Compare June 21, 2024 20:27
Copy link
Contributor

@georgexu99 georgexu99 left a comment

Choose a reason for hiding this comment

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

looks good, I'm excited to see more types in our docs :D

@erickzhao erickzhao merged commit e180450 into main Jun 21, 2024
5 checks passed
@erickzhao erickzhao deleted the typedoc-improvements branch June 21, 2024 20:52
Copy link

🎉 This PR is included in version 3.1.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