Skip to content

We can add a CITATION file to the repository to help users correctly cite the Shiro software #2489

@jbampton

Description

@jbampton

https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-citation-files

Adding a CITATION.cff (Citation File Format) or a CITATION file is a standard way to ensure that researchers and developers give the Apache Shiro project the credit it deserves in academic or professional papers.

Since Shiro is a top-level Apache project, providing a clear citation helps track its impact across the industry.

Recommended Content for CITATION.cff

The YAML-based Citation File Format is the modern standard because it's machine-readable (GitHub even renders it automatically into a "Cite this repository" button).

Why this helps the project

  • Consistency: It prevents users from guessing how to cite the project, leading to cleaner data in academic databases.
  • Visibility: GitHub highlights the citation info in the sidebar, making it easy for users to copy/paste BibTeX or APA formats.
  • Professionalism: It aligns Shiro with other major open-source projects that prioritize reproducibility and formal recognition.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions