Kagi Inc. Documentation

This repository contains open-source documentation for products made by Kagi Inc.

Contents

• Knowledgebase Map
• Support
  • Discussions
  • Community
• Contributing
  • Issues
  • Pull Requests
  • Creating a Pull Request
• Building

Knowledgebase Map

This repo serves documentation for multiple products developed by Kagi.

Our documentation efforts are ongoing! We welcome your feedback and contributions - read on for details!

Support

Discussions

On our discussions page, you will find several categories:

• Announcements, where we will post important updates related to the documentation in this repo.

• Q&A, where you can discuss and ask questions about the documentation and APIs that we offer. This is the best place to start if you're not sure of a better place!

For topics outside of the documentation & APIs, please refer to that product's official support venues, in the Community section.

Community

Each of our products has their own forum, and we encourage you to join us there. We also have a shared Discord server where you can discuss all of our products.

Discord Invite: https://kagi.com/discord

Contributing

Issues

We welcome any bug reports, requests for clarification, or other inquiries via the Issues tab.

Upon opening an issue, you will be presented with a list of templates to choose from that will help you provide us with the information we need, and triage the issue with the correct labels.

A staff member will review your issue, and help investigate what the best course of action is.

Pull Requests

Thank you for taking the time to contribute!

We welcome contributions such as:

• Fixes to incorrect statements or inaccuracies within the documentation.
• Extending documentation with details, or clarifying complicated explanations with easier to understand wording.
• Additions that fill gaps or missing pieces in the current documentation.
• Fixing of spelling and grammatical errors in the documentation.
• Adding new documentation when staff calls on the community to prepare new sections.

We would ask that you withhold:

• Whitespace or formatting changes.
• Subjective wording changes.
• Modifications to the overall structure and format of the documentation.
• Additions needlessly restructure current documentation.
• Additions that document unreleased product functionality.

If you are not sure, please feel free to open an issue first, and we will help guide you along!

Creating a Pull Request

1. Create a fork of this repo
2. Create a branch: git checkout -b username/my-cool-change
3. Follow the Building instructions to compile the book you would like to change
4. Make your changes
5. Commit your changes: git -am 'Update documentation'
6. Push the branch to your fork: git push origin username/my-cool-change
7. Create a new Pull Request

A template in the pull request form will guide you in providing any additional details we need to help accept your changes.

Building

Kagi's docs generated by Vitepress.

Development on your localhost

npm install
npm run docs:dev