๐ Capture and share your insights with Reports, Snapshots & Timelines.
This chapter covers two key ways to document and communicate your analysis results in QVscribe: Reports and Snapshots + Timelines.
- Reports are customizable, professional-quality exports that help you share results with your team.
- Snapshots + Timelines (Cloud-only) let you capture and compare different points in time to track requirement quality and progress across reviews.
Whether you're documenting findings or demonstrating improvements, these tools make it easy to keep everyone aligned.
Chapter 4
Reports
Snapshots and Timelines
Use Case: Snapshots and Timelines
Chapter 4.1: Reports
๐ฅ Video coming soon
A walkthrough video for this section is currently in the works. Check back shortly!
๐ Reports: Tailored Documentation for Every Stage
QVscribe Reports compile the results of your analysis into a modular HTML or PDF format. You can fully customize whatโs included, making it easy to create different versions depending on your audience or purpose.
๐ To generate a report, click Generate Report from the QVscribe Pane, select which sections you want, and export.
Hereโs what you can include in a report:
-
โ Individual Requirements:
Include all requirements or filter by score range. Each includes Quality Analysis results with issues and phrases highlighted, as well as Similarity, Consistency, and EARS compliance details. -
๐ Score Summary:
Shows a histogram of score distribution and risk breakdown. Great for stakeholders unfamiliar with QVscribe scoring. -
๐งฉ Analysis Breakdown:
Totals for alerts and warnings by problem type, plus overall EARS compliance rate (keep in mind 100% EARS compliance is not necessary). -
๐ Term and Unit Consistency:
Shows all detected domain-specific terms and units, making it easy to spot anything unexpected. -
๐ Requirement Similarity:
Lists the top similar requirement pairs, categorized by percentage match. Helps spot duplications or contradictions. To see all similar requirement pairs, open the document in QVscribe. -
๐ Configuration Appendix:
Lists active problem types and triggers, plus all potential units defined in your configuration. Useful for configuration onboarding and refinement.
๐ฆ Coach QRex: Start with a simple baseline report, then adjust the sections as needed to match your teamโs workflow.
Go to the beginning of Chapter 4
Chapter 4.2: Snapshots and Timelines (Cloud-only; COMING SOON TO MS OFFICE)
๐ฅ Video coming soon
A walkthrough video for this section is currently in the works. Check back shortly!
๐ธ Snapshots: Capture a Moment in Time
A Snapshot is a static capture of your current analysis, including all quality scores, alerts, and consistency data.
๐ก Use Snapshots To:
-
Save a baseline before editing
-
Capture a version for team review
-
Record your progress at key milestones
๐งญ You can take a Snapshot any time from the Summary View.
๐ Timelines: Visualize Quality Trends Over Time
A Timeline is created by comparing multiple Snapshots. It gives you a powerful view of how your document is evolving.
๐ต๏ธโโ๏ธ Timelines Show:
-
Changes in average and individual requirement scores
-
Trends in issue types
-
Shifts in quality indicators
This helps you communicate improvement, justify changes, and guide next steps with clarity.
๐ Use Case: Track Improvements Through Drafts
Youโre revising a system specification and want to monitor quality as you go. Here's how:
-
Run your first analysis
-
Create a Snapshot to capture a baseline of current quality.
-
-
Review and revise
-
Use QVscribeโs alerts, scores, and guidance to make improvements.
-
-
Create another Snapshot
-
Take a new Snapshot after changes to track whatโs improved.
-
-
Open Timelines
-
Compare Snapshots to visualize trends and score improvements.
-
-
Repeat through each draft
-
Continue capturing Snapshots as you iterate for a clear, versioned history of your progress.
-
๐ Summary:
QVscribeโs Reports, Snapshots, and Timelines provide a complete toolkit to document quality, track edits, and align your team throughout the lifecycle of your requirements. Start capturing progress today and make every iteration count.
Go to the beginning of Chapter 4