This is the repo for the Amplitude developer docs site.
We use Material for MkDocs to create our docs.
If you have any questions, comments, or concerns open an issue.
Anyone can suggest changes to the docs. Just open a PR with your changes! See our contribution guide to get started.
📌 This is an abbreviated version of the install instructions. For a full walkthrough that includes optional steps to create the best contributor experience, check out the Amplitiude Developer Center Wiki
Before you can install, you need pip. To install the link checker and Vale locally, you need brew and npm too.
-
Install Material. This command installs almost every dependency.
pip install mkdocs-material
-
Install the git revision plugin
pip install mkdocs-git-revision-date-plugin
-
(Optional) Install Vale and markdown-link-check. See the Wiki for full details.
-
Get the repo.
- Ampliteers: clone the repo:
git clone https://github.com/Amplitude-Developer-Docs/amplitude-dev-center.git
. If you aren't on the team, request access in #dev-doc-requests. - Everyone else: Fork the repo.
- Ampliteers: clone the repo:
-
Preview changes locally using
mkdocs serve
-
When you're ready, open a PR against main. Fill out the pull request template the best you can.
-
Check your PR preview build. The bot will add a PR comment with the link.
-
Merge. After your PR is approved, you can merge it if you have write access. If you don't someone on the team will merge for you.
📌 The files in the repo make use of Insiders features. If you don't have Insiders, you can still build, but some features won't render in your build. However, you can see them on the preview site when you open a PR.