Jane's QA Feedback
Added by
Troy P.
Column
Assigned to
Notes
🛠️ Formatting & Structure Fixes
1. Use More Visual Hierarchy in Responses
Current issue: Large, dense paragraph blocks with no hierarchy.
Fix: Use:
Bold for key points
Italics for emphasis or definitions
Inline code for commands or terms
Horizontal rules (---) to break sections
Whitespace between paragraphs
2. Convert Lists into Proper Bullet or Numbered Format
Current issue: Steps or lists appear as long paragraphs.
Fix: When providing steps or key ideas:
Use numbered lists for sequences:
markdown
Copy
Edit
1. Do this
2. Then this
3. Finally that
Use bulleted lists for non-sequential items:
markdown
Copy
Edit
- Clarity
- Brevity
- Formatting
3. Make Practical Steps Look Like Actionable Tasks
Current issue: "Practical Steps" appear as descriptive blurbs, not action-oriented.
Fix: Format them like a checklist or instruction guide:
markdown
Copy
Edit
✅ Step 1: Define your audience.
✅ Step 2: Outline your message.
✅ Step 3: Format with structure.
🔗 Hyperlink Fixes
4. Automatically Format URLs as Clickable Links
Current issue: Raw URLs are shown without hyperlinking.
Fix: Detect and wrap any URL like this:
markdown
Copy
Edit
[View resource](https://example.com)
💬 Tone & Directness Fixes
5. Provide Clear, Direct Answers First
Current issue: Feels like the bot is "beating around the bush."
Fix: Begin with a short, direct answer or summary before elaboration.
Example:
Yes, you can do that. Here's how:
6. Frontload Value / TL;DR Summary
Current issue: Important takeaways buried in text.
Fix: Add a "Quick Summary" or “TL;DR” box at the top when applicable.
✅ Optional: Usability Enhancements
7. Offer Copy Buttons (if feasible in UI)
For code blocks or checklists.
8. Add Emojis or Icons Sparingly
To visually cue sections (like ✅ for steps, 🧠 for insights, 📌 for tips).
1. Use More Visual Hierarchy in Responses
Current issue: Large, dense paragraph blocks with no hierarchy.
Fix: Use:
Bold for key points
Italics for emphasis or definitions
Inline code for commands or terms
Horizontal rules (---) to break sections
Whitespace between paragraphs
2. Convert Lists into Proper Bullet or Numbered Format
Current issue: Steps or lists appear as long paragraphs.
Fix: When providing steps or key ideas:
Use numbered lists for sequences:
markdown
Copy
Edit
1. Do this
2. Then this
3. Finally that
Use bulleted lists for non-sequential items:
markdown
Copy
Edit
- Clarity
- Brevity
- Formatting
3. Make Practical Steps Look Like Actionable Tasks
Current issue: "Practical Steps" appear as descriptive blurbs, not action-oriented.
Fix: Format them like a checklist or instruction guide:
markdown
Copy
Edit
✅ Step 1: Define your audience.
✅ Step 2: Outline your message.
✅ Step 3: Format with structure.
🔗 Hyperlink Fixes
4. Automatically Format URLs as Clickable Links
Current issue: Raw URLs are shown without hyperlinking.
Fix: Detect and wrap any URL like this:
markdown
Copy
Edit
[View resource](https://example.com)
💬 Tone & Directness Fixes
5. Provide Clear, Direct Answers First
Current issue: Feels like the bot is "beating around the bush."
Fix: Begin with a short, direct answer or summary before elaboration.
Example:
Yes, you can do that. Here's how:
6. Frontload Value / TL;DR Summary
Current issue: Important takeaways buried in text.
Fix: Add a "Quick Summary" or “TL;DR” box at the top when applicable.
✅ Optional: Usability Enhancements
7. Offer Copy Buttons (if feasible in UI)
For code blocks or checklists.
8. Add Emojis or Icons Sparingly
To visually cue sections (like ✅ for steps, 🧠 for insights, 📌 for tips).
Subtasks
Use More Visual Hierarchy in Responses
Convert Lists into Proper Bullet or Numbered Format
Make Practical Steps Look Like Actionable Tasks
Automatically Format URLs as Clickable Links
Provide Clear, Direct Answers First
Offer Copy Buttons (if feasible in UI)
Add Emojis or Icons Sparingly
1. Use More Visual Hierarchy in Responses
-----------------------------------------
- Current issue: Large, dense paragraph blocks with no hierarchy.
- Fix: Use:
* **Bold** for key points
* *Italics* for emphasis or definitions
* `Inline code` for commands or keywords
* --- horizontal rules ---
* Blank lines between paragraphs
2. Convert Lists into Proper Bullet or Numbered Format
------------------------------------------------------
- Current issue: Steps appear as long paragraphs.
- Fix:
Numbered:
1. First step
2. Second step
3. Third step
Bulleted:
- Clear
- Concise
- Structured
3. Make Practical Steps Look Like Actionable Tasks
--------------------------------------------------
- Current issue: Steps feel like descriptions, not actions.
- Fix:
✅ Step 1: Define your audience
✅ Step 2: Outline your message
✅ Step 3: Format clearly
4. Automatically Format URLs as Clickable Links
-----------------------------------------------
- Current issue: URLs are shown as plain text.
- Fix:
Format as: [Link text](https://example.com)
5. Provide Clear, Direct Answers First
--------------------------------------
- Current issue: Responses feel vague or too long-winded.
- Fix:
- Start with a direct answer or TL;DR
- Then elaborate if needed
6. Frontload the Value
----------------------
- Current issue: Key info buried in paragraphs.
- Fix:
- Add a “Quick Summary” at the top
- Example:
TL;DR: Yes, this is possible. Here's how:
7. Add Copy Buttons (if UI supports it)
8. Use Emojis or Icons Sparingly to Cue Attention
- Example: ✅ 🧠 📌
🧠 Mindset & Philosophy Changes
6 Core ChatGPT Principles Added:
Core Behavioral Shifts: