Merge pull request #19 from OpenPathfinder/feat/improve-reports

docs/projects/visionBoard/report_management.md

@@ -4,12 +4,13 @@ title: Report Management
 slug: /visionBoard/report-management
 ---
 
-
 visionBoard has the capability of generating reports that can be used to analyze data.
 
-## Generate the Reports
+## How to Generate Reports
+
+You can generate the reports by running the workflow `generate-reports`. This will generate the HTML and JSON directly in the `output` folder. Any time that you want to refresh the reports, you need to re-run the command as the information generated is purely static.
 
-_Not yet implemented_
+You can also use this command to generate the files and relocate them to another server if you want to make this information public. The JSON files are not consumed by the HTML files, so you can include them or not in the new location.
 
 ## Showcase the Reports
 
@@ -32,4 +33,26 @@ export PORT=8080
 visionBoard workflow run --name show-reports
 ```
 
-If these variables are not set, visionBoard will default to `localhost:3000`.
+If these variables are not set, visionBoard will default to `localhost:3000`.
+
+### Screenshots
+
+This is how the reports look using the [seed data](/docs/visionBoard/database-management#seeding) from the database.
+
+### General report
+
+This is the `/output/index.html` file rendered in the browser
+
+![Screenshot of a VisionBoard Reports dashboard showing a project management interface. The dashboard has a welcome section, a projects link to GitHub, and a checklist table. The checklist table includes columns for Documentation, Title, Description, and Author, listing different security compliance guides by the OpenJS Foundation for various project phases like 'Incubating,' 'Active,' and 'Retiring.' A Compliance Checks section below lists the names, descriptions, and details of various implemented and pending security checks, such as OWASP training and enforcing MFA.](/img/visionBoard_project_report.png)
+
+Overall shows the overall summary of reports, including a checklist for security compliance guides categorized by project phases, compliance checks, and their implementation statuses. It provides a high-level overview to help users understand their project status at a glance.
+
+
+### Project details
+
+This is the details page of any project listed in the `/output/projects/{name}.html` file rendered in the browser.
+
+![Screenshot of a VisionBoard Reports page detailing the GitHub project analysis. The page contains sections for alerts, results, tasks, OSSF Scorecard Analysis, and GitHub repositories in scope. An alert notes 'No Software Design Training found,' categorized as critical and marked failed. Results include checks for GitHub organization MFA and software design training, with statuses passed and failed, respectively. The OSSF Scorecard Analysis highlights a repository, 'octocat/Hello-World,' with metadata like commit ID, duration, date, and score. The GitHub organization 'GitHub' and its associated repository are also listed with details about stars, forks, and open issues.](/img/visionBoard_project_report_details.png)
+
+
+It illustrates the detailed view of an individual project's analysis. It highlights alerts, results, tasks, OSSF Scorecard Analysis, and GitHub repositories in scope, providing actionable insights and areas of improvement for a specific project.