Skip to content

Commit 701fbfc

Browse files
committed
Revert "Made changes to documentation"
This reverts commit 3440d15.
1 parent 8507a6c commit 701fbfc

File tree

1 file changed

+21
-56
lines changed

1 file changed

+21
-56
lines changed

README.md

Lines changed: 21 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -1,65 +1,30 @@
11
# quantifying
22

3-
Quantifying the Commons - Measuring the diversity of Openly Licensed and Public Domain Works
3+
Quantifying the Commons
44

55

66
## Overview
77

8-
This project seeks to quantify the size and diversity of the creative commons legal tools. We aim to track the collection of works(articles, images, publications) that are openly licensed or in the public domain. The project automates data collection from multiple data sources, processes the data, and generates reports.
9-
10-
#### The three phases of generating a report:
11-
12-
- 1-Fetch - This phase involves collecting data from a specific source using its API. Before writing any code, we plan the analyses we want to perform by asking meaningful questions about the data. We also consider API limitations (such as query limits) and design a query strategy to work within those constraints.
13-
14-
- Meaningful questions
15-
The reports generated by this project (and the data fetched and processed to support it) seeks to be meaningful. We hope this project will provide data and analysis that helps inform discussions about the commons--the collection of works that are openly licensed or in the public domain.
16-
The goal of this project is to help answer questions like:
17-
- How has the world's use of the commons changed over time?
18-
- How is the knowledge and culture of the commons distributed?
19-
- Who has access (and how much) to the commons?
20-
- What significant trends can be observed in the commons?
21-
- Which public domain dedication or licenses are the most popular?
22-
- What are the correlations between public domain dedication or licenses and
23-
region, language, domain/endeavor, etc.?
24-
25-
- Limitations of an API
26-
- Some data sources provide APIs with certain limitations. A common limitation is a daily or hourly query limit, which restricts how many requests can be made in a given time period. To work around this, we carefully plan our queries, batch requests where possible, and schedule fetch jobs to stay within the allowed limits.
27-
- Headings of data in 1-fetch
28-
- [Tool identifier](https://creativecommons.org/share-your-work/cclicenses/): A unique identifier used to distinguish each Creative Commons legal tool within the dataset. This helps ensure consistency when tracking tools across different data sources.
29-
- [SPDX identifier](https://spdx.org/licenses/): A standardized identifier maintained by the Software Package Data Exchange (SPDX) project. It provides a consistent way to reference licenses and improves interoperability across systems.
30-
31-
2-Process: In this phase, the fetched data is transformed into a structured and standardized format for analysis. The data is then analyzed and categorized based on defined criteria to extract insights that answer the meaningful questions identified during the fetch stage.
32-
33-
3-report: This phase focuses on presenting the results of the analysis. We generate graphs and summaries that clearly show trends, patterns, and distributions in the data. These reports help communicate key insights about the size, diversity, and characteristics of openly licensed and public-domain works.
34-
35-
#### Automation script
36-
For automating these steps, the project uses Python scripts to fetch, process, and report data. GitHub Actions is used to automatically run these scripts on a defined schedule and on code updates. It handles task execution, manages dependencies, and ensures the workflow runs consistently.
37-
38-
- Script assumptions
39-
Execution schedule for each quarter:
40-
- 1-Fetch: first month, 1st half of second month
41-
- 2-Process: 2nd half of second month
42-
- 3-Report: third month
43-
44-
- Script requirements
45-
- Must be safe
46-
- Scripts must not make any changes with default options
47-
- Easiest way to run script should also be the safest
48-
- Have options spelled out
49-
- Must be timely
50-
- Scripts should complete within a maximum of 45 minutes
51-
- Scripts shouldn't take longer than 3 minutes with default options
52-
- That way there’s a quicker way to see what is happening when it is running; see execution, without errors, etc.
53-
- Then later in production it can be run with longer options
54-
- Must be idempotent (Idempotence - [Wikipedia](https://en.wikipedia.org/wiki/Idempotence))
55-
- This applies to both the data fetched and the data stored.
56-
If the data changes randomly, we can't draw meaningful conclusions
57-
- Balanced use of third-party libraries
58-
- Third-party libraries should be leveraged when they are:
59-
- API specific (google-api-python-client, internetarchive, etc.)
60-
- File formats
61-
- CSV - the format is well supported (rendered on GitHub, etc.), easy to use, and the data used by the project is simple enough to avoid any shortcomings.
62-
- YAML - prioritizes human readability which addresses the primary costs and risks associated with configuration files.
8+
This project seeks to quantify the size and diversity of the commons--the
9+
collection of works that are openly licensed or in the public domain.
10+
11+
12+
### Meaningful
13+
14+
The reports generated by this project (and the data fetched and processed to
15+
support it) seeks to be meaningful. We hope this project will provide data and
16+
analysis that helps inform discussions about the commons--the collection of
17+
works that are openly licensed or in the public domain.
18+
19+
The goal of this project is to help answer questions like:
20+
- How has the world's use of the commons changed over time?
21+
- How is the knowledge and culture of the commons distributed?
22+
- Who has access (and how much) to the commons?
23+
- What significant trends can be observed in the commons?
24+
- Which public domain dedication or licenses are the most popular?
25+
- What are the correlations between public domain dedication or licenses and
26+
region, language, domain/endeavor, etc.?
27+
6328

6429
## Code of conduct
6530

0 commit comments

Comments
 (0)