apache / apache/cloudstack

We can add a CITATION file to the repository to help users correctly cite the CloudStack software.

未關閉
#12,255 1 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視
no-issue-activity type:enhancement
主要語言
Java
星號
3.1k
分支
1.4k
平均合併
6 天 19 小時
30 天內合併 PR
32

描述

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

Yes, a GitHub citation file, specifically a **`CITATION.cff`** file using the Citation File Format (CFF), would be **appropriate and beneficial** for Apache CloudStack to use in its GitHub repository.

### 🎯 Why a `CITATION.cff` File is Suitable

1. **Open Source Best Practice:** Adding a `CITATION.cff` file is widely considered a best practice for open-source software, especially for projects that might be referenced in academic, industry, or research papers. GitHub actively supports this format.
2. **Ease of Citation:** The file makes it extremely easy for users to correctly cite the software. GitHub automatically detects the `CITATION.cff` file and displays a "Cite this repository" link on the repository page, which provides pre-formatted citations in styles like APA and BibTeX.
3. **Recognition for Contributors:** Proper citation ensures that the project and its contributors receive appropriate academic and professional credit when their work is used or built upon. This is a key principle of open-source and research work.
4. **Machine- and Human-Readable:** The format is simple YAML, which is easy for humans to read and machines (like citation generators) to parse, ensuring accuracy across various platforms and tools.
5. **Alignment with Apache's Status:** Apache CloudStack is a Top-Level Project (TLP) of the Apache Software Foundation and is a mature, widely used IaaS platform. Providing a clear citation method reinforces its status as a foundational piece of technology that warrants formal reference.

### 📝 Key Details for CloudStack's Citation

If Apache CloudStack were to implement this, the `CITATION.cff` file would likely specify:

* **Type:** `software` or `software-code`.
* **Title:** "Apache CloudStack" (or similar).
* **Authors:** The collective organization (Apache Software Foundation, on behalf of the project contributors).
* **Version:** The current major/minor version (e.g., `4.21.0.0`).
* **Date Released:** The date of the corresponding release.
* **License:** The Apache License Version 2.0.

It is a common practice for large projects like Apache CloudStack to leverage features like the `CITATION.cff` file to ensure their work is properly credited.

貢獻指南

開啟貢獻指南

研究方向

先從 issue 中連結的 GitHub citation-files 文件開始,然後為 Apache CloudStack 建立一個儲存庫層級的 CITATION.cff。使用列出的專案標題、作者資訊、版本、發行日期和 Apache License 2.0 詳細資訊;當該檔案能為軟體提供清楚的引用時,工作就完成了。

由索引模型根據 Issue 內容生成。

評估

領域
documentation
Issue 類型
文件
難度
2/5
預估耗時
1-3 小時
活躍度
冷清
描述清晰度
基本清楚
新手友好度
55/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。