Sources

Sources are the code repositories and other inputs a product connects, so Cactus can learn how the product behaves and write its help pages. You set GitHub repositories and flag tools under Settings › Sources, docs and Intercom imports under Settings › Imports, and the pages and answers Cactus keeps as true under What Cactus takes as true.

On this page

Connect GitHub repositories

  1. In Settings › Sources, select Connect GitHub. It opens GitHub, and until a connection is made the GitHub row reads “Not connected.”

  2. Select Pick repositories. The picker lists the repositories your GitHub account lets Cactus read.

  3. Tick the repositories you want and save the selection.

While the picker is open it takes the place of the repository rows, and a save or a Cancel closes it. A product that reads no repository has no Cancel, so the picker stays open.

Each repository row shows its branch, and shows main when none is set.

To add someone else’s public repository, fork it into a GitHub account connected to Cactus, then pick the fork.

Remove a repository

  1. In Settings › Sources, select Remove beside the repository.

Cactus stops reading a repository once it is removed. Any member of the product’s team can remove one.

The panel also says published pages stay until the next build, but removing a repository starts a build straight away.

If that build cannot start, the repository stays removed and the message asks you to press Rebuild. Each build’s run is shown on Builds.

Connect a flag tool

Flag tools let Cactus read which flags are on when it writes a page that checks one.

Each tool’s row says how many flags your code checks with it, or that it finds none.

A flag that PostHog leaves out of its answer reads as off.

Connect PostHog

  1. Select Connect PostHog. Cactus sends you to PostHog to sign in.

If PostHog’s projects don’t settle which project is yours, the connection waits for the owner’s choice, and it reads no flags until then.

Connect LaunchDarkly

  1. Select Connect LaunchDarkly, paste a LaunchDarkly access token with the Reader role into Reader token, and select Find projects.

  2. Pick the project and the environment, then select Save. Cactus reads the pick back from LaunchDarkly before it saves it.

Finding projects uses the token once and stores nothing, and saving stores the token encrypted.

Disconnect a flag tool

  1. Select Disconnect on the tool’s row.

Any member of the product’s team can disconnect a flag tool. Disconnecting removes the product’s project, and the token too once no product of the team reads through it.

Import a docs site or Intercom conversations

Imports bring in your old help center or support history, once.

Import a docs site

  1. In Settings › Imports, paste the address into Docs site or old help center, then select Import.

  2. A running import shows as Importing until it ends, then as Imported or Failed.

  3. Select Show to see the topics an import read, and Remove to delete the import.

Removing an import deletes it and what it read. Only a topic marked obsolete has a Remove of its own.

Import Intercom conversations

  1. Select Connect Intercom. Where Cactus has its Intercom app set up, the button appears, and elsewhere the row says “Intercom isn’t available yet.”

  2. Select Import conversations.

  3. Select Disconnect to remove the Intercom connection. This deletes the Intercom import and the conversations Cactus read.

If Intercom refuses the token, the row says “Intercom refused the token. Connect Intercom again.” and the connection is taken away.

Pages and answers you attached

What Cactus takes as true lists the pages you attached, the answers you kept and the writing rules. These tell Cactus what the code can’t.

A page shows Holds or Unavailable beside it.

Select Remove beside a page or an answer. A member can remove what they attached, and a team owner can remove anyone’s.

Writing rules are not removed on this page. They are kept under Settings.

If a source change fails

What you see

What it means

What to do

“Pick at least one repository.”

What it means

The save had no repository ticked.

What to do

Tick at least one repository, then save.

“Cactus couldn’t start reading these repositories. Try again.”

What it means

Cactus refused the save, and the repositories went back to what they were.

What to do

Try again.

“Cactus couldn’t confirm the build started. Press again: it won’t start a second one.”

What it means

The build may or may not have started.

What to do

Save again. A repeat sends the same build once.

“Cactus couldn’t remove that repository. Nothing changed. Try again.”

What it means

The repository is still on the product.

What to do

Try again.

“… is removed, but Cactus couldn’t start the rebuild that takes its pages down. Press Rebuild to finish.”

What it means

The repository is removed, and its build did not start.

What to do

Press Rebuild.

“PostHog refused Cactus’ access. Connect again to fix it.”

What it means

The PostHog token was refused.

What to do

Select Connect again.

“LaunchDarkly refused this token. Disconnect, then connect with a new Reader token.”

What it means

The LaunchDarkly token was refused.

What to do

Disconnect, then connect with a new Reader token.

“You didn’t add this source, so only a teamspace owner can remove it.”

What it means

A member tried to remove a page or answer another member added.

What to do

Ask a team owner to remove it.

Sources

Related pages