Q&A answers seem wrong or outdated

Overview If the Docs → Ask panel gives an answer that feels wrong, missing details, or outdated, you can quickly improve results. Use three tools:

• Refresh indexing so Moxie Docs sees the latest docs
• Add context with search and links in your question
• Send feedback with tags to teach the system what went wrong

Before you start

• Make sure the docs you expect to see are already merged into your GitHub repository. Moxie indexes what’s in the repo.

1. Refresh indexing to pull in recent doc changes If answers mention old behavior, start by refreshing indexing so the Q&A panel uses the latest docs.

1. Open Moxie Docs and go to the Docs workspace.
2. In the left navigation, open Docs → Ask.
3. At the top of the Ask panel, select Refresh or Reindex (if you see the refresh control). If you don’t see a refresh control, wait a few minutes after your repo changes merge; Moxie updates indexing on its own.
4. Ask your question again.

Tip: If your team recently merged large documentation updates, give indexing a short window to complete before retrying.

2. Add context to your question for better answers Clear, specific questions lead to better results, especially in big repositories.

1. In Docs → Ask, enter a focused question. Example: “How do we authenticate the CLI in v2?” instead of “How does auth work?”
2. Include names of relevant components, file or page titles, or version labels that appear in your docs.
3. Use the Docs workspace search bar to find the most relevant doc pages. Skim the results.
4. Copy a doc page title or link from search and paste it into your question to steer the answer toward the right material.

3. Use feedback tags to improve future answers Every answer has a feedback widget.

1. Under the answer, select thumbs up or thumbs down.
2. If you choose thumbs down, pick one or more tags:
   • Wrong: The content isn’t correct.
   • Missing context: The answer is too vague or skipped key details.
   • Outdated: The answer reflects old behavior or versions.
3. (Optional) Add a short comment that explains what should change. Examples: “We renamed this flag to --token,” or “Use v2 endpoints now.”
4. Submit. Your feedback helps Moxie tune future answers and prioritize doc improvements.

4. When to use search instead of Q&A For quick lookups of a known topic, search can be faster.

1. Go to the Docs workspace.
2. Use the search bar to enter keywords, component names, or page titles.
3. Open the most relevant page to verify details, then return to Docs → Ask if you still need a synthesized answer.

5. If answers are still off after refreshing

• Re-ask with added context and links from search results.
• Confirm the correct information exists in your repo docs. If it doesn’t, update the docs in GitHub. After merge, refresh indexing and try again.

FAQ

• Will feedback change the current answer right away? Not always. Feedback improves future answers and helps your team keep docs accurate over time.
• Do I need special permissions? You can use Docs → Ask, search, and feedback in the Docs workspace. Updating the source docs requires GitHub access in your repo.