Notebooks

This is a collection of notebooks built for generating Fedora community insights and analytics using only publicly available data.

To speed up the process, we just render the updated reports with their saved data and they are not refreshed on a schedule, but could be.

Data Sources

Each notebook has a reference to a variable called DATA_SOURCES which is used to define the location for the source files. If this is replaced during execution, this can provide the current path for the data for each notebook.

# @replace DATA_SOURCES
DATA_SOURCES = {"badges": "/home/jovyan/work/badge/output", "datagrepper-parse-accounts": "/home/jovyan/work/bus2parquet/output_users"}

Publishing using Quarto

To publish the reports, there is a defined _quarto.yml file with the details for how the pages should be published.

An index is generated using the index.qmd file and then using command below, we generate the webpages for viewing.

docker run --rm -v "$PWD:/project" -w /project ghcr.io/quarto-dev/quarto quarto render