guidance tab

app.py

@@ -486,7 +486,42 @@ with gr.Blocks(title="Audit Q&A", css= "style.css", theme=theme,elem_id = "main-
                 
                 """)
 
+    # ---- New Guidelines Tab ----
+    with gr.Tab("Guidelines", elem_classes="max-height other-tabs"):
+        gr.Markdown("""
+# Guidelines
 
+Welcome to Audit Q&A, your AI-powered assistant for exploring and understanding audit reports. This tool leverages advanced language models to help you get clear and structured answers based on audit publications.
+
+## Crafting Effective Prompts
+
+- **Be Clear and Specific**: Clearly state your question and include details such as report type, year, or specific sections if applicable.
+- **Provide Adequate Context**: Mention the report category or even specific subsections that could help the model better understand your question.
+- **Avoid Ambiguity**: Use direct, focused language; for example, instead of asking "What are the findings?" try "What are the key findings regarding revenue compliance in the Kampala Region? (Note - it helps to combine this approach with filters - see below)"
+  
+## Best Practices
+
+- Start with a simple, focused question.
+- Follow up with additional context if your initial query is too broad.
+- Experiment with different phrasings to get the most accurate answers.
+- Use the source citations as a reference to validate the provided information.
+
+## Utilizing Filters
+
+- **Report Category & Subtype**: Use the "Reports" tab to choose your preferred report category and refine your query by selecting a specific sub-type. This will help narrow down the context for your question.
+- **Year Selection**: Choose one or more years from the "Year" filter to target your query to specific time periods.
+- **Specific Reports**: Optionally, select specific reports using the dropdown to focus on a particular document or set of documents.
+
+## Useful Resources
+                    
+- Short Course: Generative AI for Everyone (3 hours) https://www.deeplearning.ai/courses/generative-ai-for-everyone/
+- Short Course: Advanced Prompting with OpenAI O1 (1 hour) https://www.deeplearning.ai/courses/ai-for-everyone/
+- Short Course: Introduction to AI with IBM (13 hours) https://www.coursera.org/learn/introduction-to-ai
+
+
+Enjoy using Audit Q&A and happy prompting!
+        """)
+    
     # static tab for disclaimer
     with gr.Tab("Disclaimer",elem_classes = "max-height other-tabs"):
         with gr.Row():