StatSocAus / oceaniaR-hack

OceaniaR Hackathon 2024
7 stars 0 forks source link

Custom Quarto Report Tempaltes #14

Open deanmarchiori opened 2 months ago

deanmarchiori commented 2 months ago

National Statistical Offices in the Pacific region routinely develop reports on a range of matters. Having customised quarto reports could help standardise and improve the quality and timeliness of report generation in the new Quarto framework.

gvdr commented 1 month ago

Bringing some detail and love to this issue :-) This is project is in sync with #12, and might be run in parallel or all together.

We at the Pacific Community | Communauté du Pacifique disseminate a treasure trove of Pacific data through our SPC .Stat portal. The data is available in a very robust model, SDMX , adopted globally by many other international organizations (UN, WHO, ILO, Eurostat, ...); the datasets are accessible through well-documented Rest(ish) API and a Data Explorer web interfaced.

SDKs for SDMX exists in various languages, including a couple in R. However, they tend to be very general, and more looking forward the SDMX-savvy user: some simple tasks are less easy to do that one would like (i.e., collecting all the data for a specific country or set of countries, extracting metadata in a tidy format, ...). #12 proposes to write a package covering the gap left between {rsdmx} and the users will be great. #14 (this issue) instead is aimed at creating nice pre-baked templates in Quarto to produce reports from our SDMX data, so to ease the tasks of users. Technically, what might be built is a Quarto Project type containing various goodies (SPC / Pacific styling, image assets, helper functions, ...)

As for what might be needed to build (think in terms of things you might learn, rather than prereqs for the project):