Write with Pageloop

Ask Pageloop

Ask about your documentation and Pageloop, choose an answer depth, and answer the agent's questions from Slack.

Ask Pageloop

Use Ask to find and understand your workspace's documentation, explain an Inbox suggestion, or get help using Pageloop. Keep a chat beside the page you are reviewing, or open the Ask page for a full-page conversation.

Ask in the Pageloop app is available to admins and editors. Contributors do not have Ask. Slack has separate access rules, described below.

Ask a question

  1. Select Ask in the sidebar to open the Ask page.
  2. Type a question in Ask Pageloop. Name the article, topic or Inbox item you want help with, and say what you need to know.
  3. Choose an Answer depth, or leave Standard selected.
  4. Select Send, or press Enter.
  5. Read the answer and any linked sources. Ask a follow-up in the same chat to clarify the answer or narrow the task. If Ask needs information from you, answer its questions before continuing.

Ask beside a page

Select Ask in the page header to open the side panel without leaving the page. Use the panel when you want help with an article, an Inbox item or the settings you are looking at. Ask receives context about the page, so you can ask questions such as “Summarise this article” or “Why was this suggested?”

  • Select Expand to full page in the panel header to continue the same chat on the Ask page.
  • Select Close to hide the panel.
  • Select New chat (the plus button in the panel header) to start a separate conversation. The Ask page also has a New chat button. Use a separate chat when you switch to an unrelated topic.
  • Select Chat history to return to an earlier conversation.

Use suggested prompts

An empty chat offers prompts you can select to send a question immediately. On the Ask page, prompts include Review my Inbox, Find outdated articles and How do I invite an editor?

In the panel, the Suggested list changes with the page. An article offers Summarise this article and Which pages link here? An Inbox item offers questions about why the change was suggested and which articles it edits. Use these prompts as starting points, then ask a follow-up with the details you need.

Choose an Answer depth

Select the depth control beside Attach in the composer before sending your question. The control shows the selected option: Fast, Standard or Deep. Pageloop remembers your selection in that browser.

OptionWhen to use itWhat changes in the response
FastTry it for a straightforward lookup, a short summary or a question about where to find a setting.Uses a quicker model if one is set up; otherwise uses the default model.
StandardUse it for everyday questions about your docs, Inbox and Pageloop. It is the default selection.Uses the default model.
DeepTry it for a complex question that compares articles or needs careful reasoning.Uses a stronger model if one is set up; otherwise uses the default model.

Answer depth selects the model used to answer; it does not select a different set of sources or tools. Deep does not guarantee a longer answer or a wider search, and Fast does not guarantee a shorter answer. Tell Ask explicitly if you want a brief summary, a detailed explanation or a comparison table. If separate models have not been set up, all three options use the default model.

Useful questions to ask

Ask helps with Pageloop and your workspace's documentation, rather than unrelated general-purpose questions. Give Ask a topic, page title or desired outcome so the answer has a clear scope.

GoalExample question
Find documentation“Which articles explain SSO setup?”
Understand a page“Summarise this article for someone setting up the product for the first time.”
Compare coverage“Compare our SSO setup articles. Where do they repeat the same instructions?”
Improve wording“Rewrite this paragraph in plain language without changing the steps or limits.”
Understand a suggestion“Why was this suggested, and which articles does it edit?”
Prioritise review“What should I review first in my Inbox?”
Learn Pageloop“How do I invite an editor?”
Understand your setup“Which integrations are connected, and what would Linear add?”

Turn a conversation into a docs run

When you explicitly ask Ask to write or update documentation for a product change, Ask can start a docs run automatically as its answer ends. The chat shows a link to the run. This also applies when you ask for documentation in a Slack conversation.

Give Ask the product change, the affected articles and any important steps, permissions or limits. For example: “Our CSV export includes only rows matching the selected filters. Update the export guide to explain this.”

Some tasks appear as proposals with a Start button instead. For example, Ask waits for Start before reworking an Inbox item's existing proposal. If someone answers a web-chat question through Slack and Ask then proposes a docs run, the original asker must press Start in the Pageloop chat. Review the proposed task first: these runs only start when you press Start.

A docs run produces proposed changes for review in the Inbox. Starting a run does not publish the changes. Review the result in Pageloop before publishing.

Ask from Slack

Use Ask in a Slack workspace connected to your Pageloop workspace. An admin manages the connection from Integrations. Run questions from work started outside Slack need a configured Slack notification channel.

Full members of the connected Slack workspace can ask and answer questions, even without a Pageloop account. Guests and people outside that Slack workspace cannot. This includes Slack members whose Pageloop app role is Contributor. Choose the connected workspace and notification channel with this access in mind: questions posted to the channel are visible to its members.

Start and continue a conversation

  1. Mention @Pageloop, or start a message with “pageloop”, followed by your question. For example: “@Pageloop Which articles explain SSO setup?”
  2. Read Ask's answer in the Slack thread. Ask can use the earlier messages in that thread as context.
  3. Reply in the same thread to continue. You do not need to mention Pageloop again in a thread where Ask is already answering. A reply addressed to another person, a group or the channel is left alone.

If Ask asks a conversational follow-up in the thread, reply there. For a paused docs run's questions, use the form described below instead of a plain thread reply.

You can also ask Pageloop to document a change discussed in the thread. The thread receives the run link and the outcome; review the proposed documentation in Pageloop before publishing.

Answer the agent's run questions

When a docs run pauses for your input, Pageloop posts its questions to the run's Slack thread. If the run did not start in Slack, the questions go to the configured notification channel. Help center runs are included.

  1. Select Answer questions on the Slack message.
  2. Complete the questions in the Pageloop questions form. Choose the requested options or type an answer, and add details where the form allows them.
  3. Select Send answers to submit the whole round. The run continues with your answers.

The message shows who answered. If someone answers in Pageloop instead, the Slack message changes to Answered in Pageloop. Use Open in Pageloop to review the run or answer there.

Answer a question from a Pageloop chat

Ask can also send an unanswered question from a web chat to the Slack notification channel after about 10 minutes. The post is titled A question from Ask in Pageloop and has Answer questions and Open in Pageloop buttons.

Use Answer questions to submit the answer form. Your answers become the next message in the original chat, with your Slack name attached. Ask continues in Pageloop, not as a separate Slack conversation. The Slack post says who answered and that the chat is continuing in Pageloop. If the chat has already moved on, the old question no longer needs an answer.

If Slack does not answer

  • If the Slack connection shows Needs reconnecting, ask an admin to reconnect it in Integrations.
  • A Slack workspace connected to more than one Pageloop workspace cannot use Ask or receive run posts. Ask an admin to keep a single Pageloop connection for that Slack workspace.

For documentation page structure and navigation conventions, see Writing docs.