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
In Settings › Sources, select Connect GitHub. It opens GitHub, and until a connection is made the GitHub row reads “Not connected.”
Select Pick repositories. The picker lists the repositories your GitHub account lets Cactus read.
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
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
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
Select Connect LaunchDarkly, paste a LaunchDarkly access token with the Reader role into Reader token, and select Find projects.
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
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
In Settings › Imports, paste the address into Docs site or old help center, then select Import.
A running import shows as Importing until it ends, then as Imported or Failed.
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
Select Connect Intercom. Where Cactus has its Intercom app set up, the button appears, and elsewhere the row says “Intercom isn’t available yet.”
Select Import conversations.
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. |