Installation
Installing Hyperlint
Hyperlint runs as a GitHub App, integrating directly with your repository.
Our installation process is standard in industry and is similar to other Github Apps like Dependabot and Cloudflare Pages.
There are several steps you will need to follow to start using Hyperlint:
-
Register for Hyperlint Navigate to the Hyperlint Dashboard and sign in with Github.
-
Install the Hyperlint GitHub application Either by navigating directly to the application or simply following any of the links on the dashboard like seen in the following image:
That will take you to Github, where you will click the big green “Install” Button.
-
Select a GitHub Account Now you’ll select the account that contains the repository(ies) that you want Hyperlint to monitor.
-
Select the repositories Select the repositories that you want to install Hyperlint on. You can grant access to:
- individual repositories (most common)
- or all repositories (less common)
-
Push a documentation change Lastly, push a documentation change to your repository. If you’re changing a valid file type (e.g., markdown), Hyperlint will automatically detect the changes and provide feedback.
That’s it! You’re ready to go. Check out how to get started using Hyperlint to learn how to use Hyperlint.
Installation FAQ
Does Hyperlint store personal data or information?
The only information we store is from the GitHub repository itself as seen in the “data we need access to” section. We do not store or process personally identifiable information, except for billing.
You can read our full privacy policy here.
Will Hyperlint take actions on my behalf?
Github Apps are a stable and routine way of giving third-party access to Github resources. Hyperlint does not take actions as individual or installing users (as described in the OAuth documentation). All authentication is performed as a Github App installation.
What permissions does Hyperlint need?
Hyperlint’s Github App needs several permissions to function:
Checks and Commit Statuses
Hyperlint runs checks on the code and provides status updates on particular commits. This is how Hyperlint provides feedback on the code.
Read more about Checks and Commit Statuses on the Github Documentation.
Repository Contents
Hyperlint makes edits to your code for you. That means we’ll need access to the contents of the repository including file contents, branches, and commits.
Read more about Contents on the Github Documentation.
Issues and Pull Requests
Hyperlint can create, comment on, and modify pull requests and issues. This is the key way in which you interact with the Hyperlint product.
Read more about Issues and Pull Requests on the Github Documentation.