Skip to content

About

Github Organization Information and Management Tools

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

4 watching

Forks

Latest commit

 

History

39 Commits

Folders and files

Repository files navigation

plone.github

Proposal PDF

Definitions, data and the 2026 proposal for how repositories in the Plone GitHub organization handle issues and labels.

In 2015 this repository held the tool that rolled out a numbered label scheme across the organization. That tool and the Google Sheet that documented the scheme are kept under archive/. Everything else here belongs to the 2026 proposal: fewer labels, GitHub's own features for the rest, and a lighter process for the people who triage.

Layout

archive/        the 2015 tool and the Google Sheet, as they were
data/           audit of every public repository in the org (2026-11-05)
scripts/        the fetchers and reducers that produce data/ and build/proposal.md
proposal/       Markdown sources of the proposal PDF, diagrams, PDF template,
                and the forum post
tests/          pytest suite (data privacy, language rules, build)
Makefile        make test | make pdf | make data

Build the PDF

Needs Python 3.12+, uv, pandoc, XeLaTeX with the Lato font, Graphviz and poppler-utils. On Debian/Ubuntu:

sudo apt-get install pandoc texlive-xetex texlive-latex-extra texlive-fonts-recommended fonts-lato fonts-dejavu-core graphviz poppler-utils
uv sync
make pdf          # → build/proposal.pdf
make test

Regenerate the data

make data queries the GitHub GraphQL API through the gh CLI for every public repository in the organization and rewrites data/. It needs gh auth login with read access to the org and takes about ten minutes. Private repositories are never read or written.

Discussion

The proposal is discussed on the Plone community forum (link added when posted; the post itself is proposal/forum-post.md). Feedback as issues or pull requests here is welcome too. The PDF of each proposal version is attached to a GitHub release tagged proposal-v*.

About

Github Organization Information and Management Tools

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

4 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages