Skip to content

Commit

Permalink
Add dev info to README
Browse files Browse the repository at this point in the history
  • Loading branch information
akuny committed Apr 19, 2024
1 parent 7387074 commit ae0e7b8
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 11 deletions.
37 changes: 27 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,34 @@

The [Site Scanning program](https://digital.gov/site-scanning/) automates a wide range of scans of public federal websites and generates data about website health and best practices.

This repository serves as a hub for various analysis reports, which provide summary and analytical data about the information that the Site Scanning program generates.
This repository serves as a hub for various analysis reports, which provide summary and analytical data about the information that the Site Scanning program generates.

To ask a question or leave feedback for the program, please [file an issue here](https://github.com/GSA/site-scanning/issues) or email us at [email protected].
To ask a question or leave feedback for the program, please [file an issue here](https://github.com/GSA/site-scanning/issues) or email us at [email protected].

### Important Links

* [Program Website](https://digital.gov/site-scanning)
* [API Documentation](https://open.gsa.gov/api/site-scanning-api/)
* [Central Project Repository](https://github.com/GSA/site-scanning)
* [Program Documentation Repository](https://github.com/GSA/site-scanning-documentation)
* [Federal Website Index Repository](https://github.com/GSA/federal-website-index)
* [Site Scanning Engine Repository](https://github.com/GSA/site-scanning-engine)
* [Snapshots Repository](https://github.com/GSA/site-scanning-snapshots)
* [Extensive List of Links to Technical Details, Snapshots, Analysis Reports, and More](https://digital.gov/guides/site-scanning/technical-details/) (if in doubt, look here)
- [Program Website](https://digital.gov/site-scanning)
- [API Documentation](https://open.gsa.gov/api/site-scanning-api/)
- [Central Project Repository](https://github.com/GSA/site-scanning)
- [Program Documentation Repository](https://github.com/GSA/site-scanning-documentation)
- [Federal Website Index Repository](https://github.com/GSA/federal-website-index)
- [Site Scanning Engine Repository](https://github.com/GSA/site-scanning-engine)
- [Snapshots Repository](https://github.com/GSA/site-scanning-snapshots)
- [Extensive List of Links to Technical Details, Snapshots, Analysis Reports, and More](https://digital.gov/guides/site-scanning/technical-details/) (if in doubt, look here)

### Development

These reports are generated on a continual basis by the following workflows:

- [Generate snapshot and target URL reports](https://github.com/GSA/site-scanning-analysis/blob/main/.github/workflows/generate-all-reports.yml)
- [Generate IDEA reports](https://github.com/GSA/site-scanning-analysis/blob/main/.github/workflows/generate-idea-reports.yml)
- [Generate unique website list](https://github.com/GSA/site-scanning-analysis/blob/main/.github/workflows/generate-unique-website-list.yml)

To run locally, install the necessary dependencies and call the entry point with
a valid command. For example, to generate the report that collects data for all
live websites:

```shell
pip install -r requirements.txt
python3 main.py generate-primary-snapshot-report
```
2 changes: 1 addition & 1 deletion main.py
Original file line number Diff line number Diff line change
Expand Up @@ -78,4 +78,4 @@ def generate_idea_bureau_report():
if command == 'generate-idea-report':
generate_idea_report()
if command == 'generate-idea-bureau-report':
generate_idea_bureau_report()
generate_idea_bureau_report()

0 comments on commit ae0e7b8

Please sign in to comment.