Linear
Linear is where Cactus sends the feature requests and bugs people ask for, as new issues or onto issues already there. You connect your Linear workspace once on Connect › Linear, then send requests from Conversations.
On this page
Connect Linear
Only an admin of your Linear workspace can connect it, because Linear lets only an admin install an app. Connect starts only for someone signed in to Cactus.
In Connect › Linear, select Connect.
Approve Cactus on Linear's screen. Linear sends you back to the page you came from.
If your workspace has one team, new issues go to it. Otherwise they go to the first team in Linear's list until you choose one.
Choose where new issues go
The Linear row's line says where new issues go, with the team's name and key.
In Connect › Linear, select the badge with your workspace's name, then pick a team under New issues go to.
Send a request to Linear
Until Linear is connected, Send to Linear offers to connect it first.
In Conversations, point at a request's row and select Send. The button shows while the pointer or the keyboard is on the row.
Choose New issue or Add to existing.
For a new issue, check the Title, which starts as the request's title, and the Team, then select Create issue.
For an existing issue, type words to search the team's issues, or paste a Linear link or an issue's identifier to find one in any team. Press
Enterto add the highlighted issue.
What the issue carries
The issue says how many people asked and since when, quotes the latest three asks in their own words, and lists any other ways the request was asked and its product area. Cactus also attaches a link back to the request in Cactus, titled with the number of people who asked.
Sending a request again
A request that already has an issue in Linear is linked to that issue, and nothing new is sent.
The notice that says the request was sent to Linear as an issue appears only when something was sent.
If you unlinked a request from an issue, sending it again does not pick that same issue.
Open or unlink an issue
Once a request has its issue, its actions show Open with the issue's identifier, which opens the issue in Linear, and Unlink.
Unlink takes the request off its issue in Cactus, and the issue in Linear stays as it is.
Issue states
A request shows its issue's state as Linear names it.
The state is read again when someone looks at it, once the stored one is more than ten minutes old. An open request's issue is read whatever its age. Cactus does not check Linear on a timer.
Disconnect Linear
In Connect › Linear, select the badge with your workspace's name, then hold the Disconnect item for that workspace until it confirms.
Cactus stops sending to your workspace, and the issues already sent stay linked. Cactus removes itself from the workspace only when no other product is still connected to it.
If connecting or sending fails
What you see | What it means | What to do |
|---|---|---|
"Linear access was not granted, so nothing changed here." | What it means You did not approve Cactus on Linear's screen. | What to do Select Connect again. |
"That connection request sat too long. Try Connect again." | What it means The trip to Linear and back took too long to finish. | What to do Select Connect again. |
"Linear turned the connection down. Try Connect again." | What it means Linear refused the connection, and nothing was saved. | What to do Select Connect again. |
"You were signed out part way through. Sign in, then try Connect again." | What it means Your Cactus session ended during the connection. | What to do Sign in to Cactus, then select Connect again. |
A Connect button where the workspace's badge was | What it means Linear has taken Cactus's access away, so the connection is gone for every product on that workspace. | What to do Select Connect again. |
"Linear didn’t take it. Try again." | What it means Linear refused the send. | What to do Try the send again. |
"No issue in the team's key matches. Try its number, or paste its link." | What it means Nothing in that team matches your search. | What to do Paste the issue's link or its identifier to find it in any team. |