{"id":24719355,"url":"https://github.com/best-practice-and-impact/aftables","last_synced_at":"2025-10-09T16:31:57.282Z","repository":{"id":40674135,"uuid":"397907497","full_name":"best-practice-and-impact/aftables","owner":"best-practice-and-impact","description":"R package: generate best-practice stats spreadsheets for publication","archived":false,"fork":false,"pushed_at":"2025-09-22T08:02:26.000Z","size":5186,"stargazers_count":50,"open_issues_count":25,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-24T16:49:52.344Z","etag":null,"topics":["accessibility","openxlsx","reproducible-analytical-pipeline","rstats","rstats-package","spreadsheet","uk-gov-data-science"],"latest_commit_sha":null,"homepage":"https://best-practice-and-impact.github.io/aftables/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/best-practice-and-impact.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-08-19T10:42:27.000Z","updated_at":"2025-06-25T13:31:39.000Z","dependencies_parsed_at":"2025-01-26T10:58:04.466Z","dependency_job_id":"168aca40-b4be-42b1-b77d-195fa8ce8ea5","html_url":"https://github.com/best-practice-and-impact/aftables","commit_stats":null,"previous_names":["matt-dray/a11ytables","best-practice-and-impact/a11ytables","best-practice-and-impact/aftables","co-analysis/a11ytables"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/best-practice-and-impact/aftables","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/best-practice-and-impact%2Faftables","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/best-practice-and-impact%2Faftables/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/best-practice-and-impact%2Faftables/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/best-practice-and-impact%2Faftables/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/best-practice-and-impact","download_url":"https://codeload.github.com/best-practice-and-impact/aftables/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/best-practice-and-impact%2Faftables/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001778,"owners_count":26083173,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accessibility","openxlsx","reproducible-analytical-pipeline","rstats","rstats-package","spreadsheet","uk-gov-data-science"],"created_at":"2025-01-27T11:17:45.198Z","updated_at":"2025-10-09T16:31:57.277Z","avatar_url":"https://github.com/best-practice-and-impact.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r setup, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\",\n  fig.path = \"man/figures/README-\",\n  out.width = \"100%\"\n)\n```\n\n# {aftables} \u003ca href=\"https://best-practice-and-impact.github.io/aftables/\"\u003e\u003cimg src=\"man/figures/logo.png\" align=\"right\" height=\"139\"/\u003e\u003c/a\u003e\n\n\u003c!-- badges: start --\u003e\n[![CRAN\nstatus](https://www.r-pkg.org/badges/version/aftables)](https://CRAN.R-project.org/package=aftables)\n[![R-CMD-check](https://github.com/best-practice-and-impact/aftables/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/best-practice-and-impact/aftables/actions/workflows/R-CMD-check.yaml)\n\u003c!-- badges: end --\u003e\n\n## Purpose\n\nAn R package to help automatically create reproducible spreadsheets that adhere to the guidance on [releasing statistics in spreadsheets](https://analysisfunction.civilservice.gov.uk/policy-store/releasing-statistics-in-spreadsheets/) from the UK government's [Analysis Function](https://analysisfunction.civilservice.gov.uk/), with a focus on accessibility.\n\nVisit [the {aftables} website](https://best-practice-and-impact.github.io/aftables/) for documentation.\n\n## Accessibility\n\nThis package is not yet capable of creating perfectly accessible spreadsheets but will help with the bulk of the work needed. Users of this packages should refer back to [the main spreadsheet guidance](https://analysisfunction.civilservice.gov.uk/policy-store/releasing-statistics-in-spreadsheets/) or [the spreadsheet accessibility checklist](https://analysisfunction.civilservice.gov.uk/policy-store/making-spreadsheets-accessible-a-brief-checklist-of-the-basics/) after using it to make sure nothing has been missed. Please email [analysis.function@ons.gov.uk](mailto:analysis.function@ons.gov.uk) if you use the package so they can monitor use and the outputs produced.\n\n## Contribute\n\nThe package is under (opinionated) active development. Please see [the NEWS file](https://best-practice-and-impact.github.io/aftables/news/index.html) for the latest changes. \n\nTo contribute, please add [an issue](https://github.com/best-practice-and-impact/aftables/issues) or [a pull request](https://github.com/best-practice-and-impact/aftables/pulls) after reading [the code of conduct](https://github.com/best-practice-and-impact/aftables/blob/main/.github/CODE_OF_CONDUCT.md) and [contributing](https://github.com/best-practice-and-impact/aftables/blob/main/.github/CONTRIBUTING.md) guidance. \n\n\n## Installation\n\n### Install from CRAN\n\nInstall the latest release version of aftables directly from CRAN:\n\n``` {r install from CRAN, eval=FALSE}\ninstall.packages(\"aftables\")\n```\n\n### Install from GitHub\n\nInstall the package [from GitHub](https://github.com/best-practice-and-impact/aftables) using [{remotes}](https://remotes.r-lib.org/).\n\n```{r install, eval=FALSE}\ninstall.packages(\"remotes\")  # if not already installed\n\nremotes::install_github(\n  repo = \"best-practice-and-impact/aftables\",  # GitHub user/repository\n  dependencies = TRUE,              # install required/suggested packages\n  build_vignettes = TRUE            # generate vignette documentation\n)\n```\n\n## How to install a11ytables\n\nThe original name of the aftables package was a11ytables. The package was renamed to make it consistent the [afcharts package](https://github.com/best-practice-and-impact/afcharts). Some function names were updated when the package was renamed. If you need to install a11ytables for a legacy project, the following code can be used.\n\n```{r install a11ytables, eval=FALSE}\ninstall.packages(\"remotes\")  # if not already installed\n\nremotes::install_github(\n  repo = \"best-practice-and-impact/aftables\",  # GitHub user/repository\n  ref = \"v0.3.2\", # this installs the final version of a11ytables. Change if you need an earlier version.\n  dependencies = TRUE,              # install required/suggested packages\n  build_vignettes = TRUE            # generate vignette documentation\n)\n\nlibrary(a11ytables)  # attach package\n```\n\n## Use\n\nTo create a spreadsheet:\n\n1. Use `create_aftable()`\n1. Pass the output to `generate_workbook()`\n1. Pass the output to `openxlsx::saveWorkbook()`\n\nRun `?function_name` or visit [the package website](https://best-practice-and-impact.github.io/aftables/reference/index.html) for function documentation. For long-form documentation, [visit the package website](https://best-practice-and-impact.github.io/aftables/) or run `browseVignettes(\"aftables\")` to read the:\n\n* [introductory vignette](https://best-practice-and-impact.github.io/aftables/articles/aftables.html) to get started\n* [accessibility checklist vignette](https://best-practice-and-impact.github.io/aftables/articles/checklist.html) to see how the package complies with best-practice guidance\n* [terminology vignette](https://best-practice-and-impact.github.io/aftables/articles/terminology) to understand the nomenclature of spreadsheet terms as used in this package\n* [package structure vignette](https://best-practice-and-impact.github.io/aftables/articles/structure) to see how the package works under the hood\n\nThis package also includes [an RStudio Addin](https://rstudio.github.io/rstudioaddins/) that inserts pre-filled demo skeletons of the {aftables} workflow.\n\n## Related projects\n\nThe ONS's Analysis Standards and Pipelines team has released [a Python package called 'gptables'](https://github.com/best-practice-and-impact/gptables). {aftables} is an independent effort that offers a native R solution that is very similar to gptables in its outputs, though there are some differences in implementation.\n\n{aftables} can help you fulfill a [Reproducible Analytical Pipeline](https://analysisfunction.civilservice.gov.uk/support/reproducible-analytical-pipelines/) by automating the generation of compliant spreadsheets for publication.\n\n## Code of Conduct\n\nPlease note that the {aftables} project is released with a [Contributor Code of Conduct](https://best-practice-and-impact.github.io/aftables/CODE_OF_CONDUCT.html).\n\n## Copyright and Licensing\n\n© Crown Copyright, 2023.\n\nThis work is [Crown Copyright](https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/). The source code for the software is released under the MIT licence as per the the [UK Government Licensing Framework](https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/open-government-licence/open-software-licences/) and the [GDS Way licensing guidance](https://gds-way.digital.cabinet-office.gov.uk/manuals/licensing.html). The documentation for the software is released under the [Open Government Licence](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbest-practice-and-impact%2Faftables","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbest-practice-and-impact%2Faftables","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbest-practice-and-impact%2Faftables/lists"}