Migrating your Knowledge Base

This guide will help you migrate your Knowledge Base to Pylon. Reach out to the Pylon team about migrating and we'll get on a call with you about what you're looking to migrate.

For the overall process, see 📄 Migrating your Data to Pylon

Process

Here's a high level overview of how this works

1. First step is to talk to the Pylon Migrations Team to make sure we cover your use case and there aren't any caveats or special setups. In this meeting we'll also talk about migrating your support system data.

2. Migrate the articles, either automatically with our migrator or manually by your team. Once you migrate, you will want to freeze doing changes to your KB, otherwise the two will be out of sync.

3. Setup route redirects so old links will still redirect to the correct article.

4. Cutover the DNS record and point the url at the Pylon-hosted Knowledge Base.

Key Decisions

Decision 1: What do you want to put in your Knowledge Base?

Make sure you understand the difference between a Knowledge Base and Docs.

📄 What's the difference between a Knowledge Base and Docs?

Decision 2: Do you want to migrate automatically or manually?

There are two cases we see where people like to manually migrate their KB.

Case 1: A Knowledge Base migration is a great opportunity to clean up old out-of-date articles. We often see companies take it to start fresh, especially since AI works best with a solid base of correct content.

Case 2: for companies with less than 50 articles, we recommend migrating by hand since the process ends up being faster and you can spot-check every article.