From 48719b0373d890b10adbb9ad8a9efa07c5eb09b0 Mon Sep 17 00:00:00 2001 From: John Bampton Date: Tue, 17 Nov 2026 07:45:51 +1000 Subject: [PATCH] Add CITATION file for easy and accurate citing Add pre-commit hook to validate the citation file --- .pre-commit-config.yaml | 4 ++++ CITATION.cff | 43 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+) create mode 100644 CITATION.cff diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index 3c573ec8da27..1b57c6c8b7c2 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -219,6 +219,10 @@ repos: - repo: https://github.com/python-jsonschema/check-jsonschema rev: 12e63946db2c5cfcc9030fac21c3883ba88c6ed8 # frozen: 0.38.0 hooks: + - id: check-citation-file-format + name: run check-citation-file-format + description: validate citation file format + files: ^CITATION\.cff$ - id: check-dependabot name: validate dependabot config description: ensures the dependabot config file is valid diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 000000000000..cffd76d8a2b5 --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,43 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. + +cff-version: 1.2.0 +title: Apache CloudStack +message: >- + If you use Apache CloudStack in your research, documentation, or software, + please cite it using the metadata from this file. +type: software +authors: + - name: "The Apache Software Foundation" + website: "https://www.apache.org/" +repository-code: "https://github.com/apache/cloudstack" +url: "https://cloudstack.apache.org/" +abstract: >- + Apache CloudStack is an open-source Infrastructure as a Service (IaaS) + cloud computing platform designed to deploy and manage large networks of + virtual machines, storage, and networking resources. +keywords: + - iaas + - cloud + - cloudstack + - infrastructure + - orchestration + - virtualization + - virtual-machine +license: Apache-2.0 +version: "4.23.0.0" +date-released: "2026-09-02"