Skip to main content

FAQs vs Documents

FAQs vs Documents​

There are two kinds of knowledge you can add to Wallu: FAQs (hand-written Q&A pairs) and documents (websites, PDFs, text, imported Discord channels or Git repositories).

Recommendation

Let documents do most of the work - import your website or a #wallu-knowledge channel. Modern document search is very accurate, so you rarely need an FAQ per question. Add FAQs for the answers that must be exact, and keep "Advanced FAQ AI" enabled on the FAQs page.

FAQs​

note

FAQs have higher priority than documents. If a question matches an FAQ, Wallu answers with that FAQ - so you can use one to override a document's answer.

Benefits​

  • Predictable: you write the exact answer, so there's very little chance of a wrong or made-up reply. Answers that come straight from an FAQ are tagged Verified✓.
  • Quick to start: easy to add and hard to get wrong.
  • Easy to manage: add, edit and delete from the admin panel.
  • Link-friendly: answer with a link so Wallu just points to the live page instead of reciting details.

Considerations​

  • Manual upkeep: every FAQ is maintained by hand, so stick to your most common questions rather than trying to cover everything.

Documents​

Benefits​

  • Automatic: Wallu can automatically extract information from documents and use it to answer questions.
  • Less work: You don't have to manually add questions and answers. Wallu will automatically find the answer from the document.
  • Good for large documents: If you have a large document, it's easier to add it as a document than to add each question as an FAQ.

Considerations​

  • Less transparent: it's harder to see exactly where an answer came from. Set Source Links to Always in Settings while you're testing so answers show what they were based on, and sort documents by "most used" on the Documents page to see which ones Wallu actually relies on.
  • Quality over quantity: Simply adding a lot of documents does not mean Wallu will perform better.
    • As a rule of thumb, consider whether a random person would be able to answer the question by reading the document
    • It's a lot more reliable if the documents directly answer the question instead of requiring reasoning or interpretation.