diff --git a/LICENSE.txt b/LICENSE.txt deleted file mode 100644 index 232e61ba7..000000000 --- a/LICENSE.txt +++ /dev/null @@ -1 +0,0 @@ -See: License.md \ No newline at end of file diff --git a/README.md b/README.md index fd92a2516..74b29f28a 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# FinOps Open Cost and Usage Specification (FOCUS) - Specification Working Group +# FinOps Open Cost and Usage Specification (FOCUS) - Working Group ## Overview @@ -6,14 +6,12 @@ The FinOps Open Cost and Usage Specification (FOCUS) is a community-driven effor The vision of the FOCUS project is to help the cloud and SaaS industry move toward a common vocabulary around usage and billing data. This will not only help FinOps professionals in the analysis of billing data from disparate sources but will also help software engineering teams by providing a target format for the usage and billing data that their products will generate. -Some of the usecases this capability can enable: +Some of the use cases this capability can enable: - The FOCUS spec will make it easier for FinOps practitioners to approach a new billing data source, as common concepts have been mapped to the common vocabulary of the spec. - The FOCUS spec will make it easier to merge multiple billing data sources together, and perform cross-cloud and cross-vendor analysis and cost reporting. - The FOCUS spec should make it easier to open source more FinOps visibility tools, and to accelerate the FinOps framework capability of data ingestion and normalization. -[Working Group Charter]() **Link TBC** - ## Notation Conventions and Compliance The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", @@ -24,12 +22,12 @@ The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", [[RFC8174](https://tools.ietf.org/html/rfc8174)] when, and only when, they appear in all capitals, as shown here. -An implementation of the [specification][] is not compliant if it fails to +An implementation of the specification is not compliant if it fails to satisfy one or more of the "MUST", "MUST NOT", "REQUIRED", "SHALL", or "SHALL -NOT" requirements defined in the [specification][]. Conversely, an -implementation of the [specification][] is compliant if it satisfies all the +NOT" requirements defined in the specification. Conversely, an +implementation of the specification is compliant if it satisfies all the "MUST", "MUST NOT", "REQUIRED", "SHALL", and "SHALL NOT" requirements defined in -the [specification][]. +the specification. ## Versioning the Specification @@ -37,13 +35,17 @@ Changes to the [specification](./specification/overview.md) are versioned accord ## Project Naming -- The official project name is "FinOps Open Cost and Usage Specification" -- The official acronym used by the FinOps Open Cost and Usage Specification project is "FOCUS" -- While the official acronym includes the word "Specification", it is still acceptable to refer to this working groups output as the "FOCUS Specification" +- The official project name is "FinOps Open Cost and Usage Specification". +- The official acronym used by the FinOps Open Cost and Usage Specification project is "FOCUS". +- While the official acronym includes the word "Specification", it is still acceptable to refer to this working group's output as the "FOCUS Specification". ## About the project See the [project repository](https://github.com/FinOps-Open-Cost-and-Usage-Spec/foundation) for information about the following, and more: +- [Project Charter](https://github.com/FinOps-Open-Cost-and-Usage-Spec/foundation/blob/main/FOCUS_-_Membership_Agreement_Package_for_use.pdf) +- [Operating Procedures](https://github.com/FinOps-Open-Cost-and-Usage-Spec/foundation/blob/main/operating_procedures.md) +- [Steering Committee](https://github.com/FinOps-Open-Cost-and-Usage-Spec/foundation/blob/main/steering_committee.md) +- [Release Planning](https://github.com/FinOps-Open-Cost-and-Usage-Spec/FOCUS_Spec/blob/working_draft/RELEASE-PLANNING.md) - [Change / contribution process](https://github.com/FinOps-Open-Cost-and-Usage-Spec/foundation/blob/main/contributing.md) diff --git a/specification/columns/invoiceissuer.md b/specification/columns/invoiceissuer.md index dfe03ed11..ccc89482b 100644 --- a/specification/columns/invoiceissuer.md +++ b/specification/columns/invoiceissuer.md @@ -3,7 +3,10 @@ An Invoice Issuer is an entity responsible for invoicing for the [*resources*](#glossary:resource) or [*services*](#glossary:service) consumed. It is commonly used for cost analysis and reporting scenarios. -The InvoiceIssuer column MUST be present in a [*FOCUS dataset*](#glossary:FOCUS-dataset). This column MUST be of type String and MUST NOT contain null values. +The InvoiceIssuer column adheres to the following requirements: + +* The InvoiceIssuer column MUST be present in a [*FOCUS dataset*](#glossary:FOCUS-dataset). +* This column MUST be of type String and MUST NOT contain null values. See [Appendix: Origination of cost data](#originationofcostdata) section for examples of [Provider](#provider), [Publisher](#publisher) and Invoice Issuer values that can be used for various purchasing scenarios. diff --git a/specification/columns/provider.md b/specification/columns/provider.md index a88b07b69..a838fe476 100644 --- a/specification/columns/provider.md +++ b/specification/columns/provider.md @@ -2,7 +2,10 @@ A Provider is an entity that makes the [*resources*](#glossary:resource) or [*services*](#glossary:service) available for purchase. It is commonly used for cost analysis and reporting scenarios. -The Provider column MUST be present in a [*FOCUS dataset*](#glossary:FOCUS-dataset). This column MUST be of type String and MUST NOT contain null values. +The Provider column adheres to the following requirements: + +* The Provider column MUST be present in a [*FOCUS dataset*](#glossary:FOCUS-dataset). +* This column MUST be of type String and MUST NOT contain null values. See [Appendix: Origination of cost data](#originationofcostdata) section for examples of Provider, Publisher and Invoice Issuer values that can be used for various purchasing scenarios. diff --git a/specification/versions/candidate_release.md b/specification/versions/candidate_release.md index 536156fe9..9a9e1f2ef 100644 --- a/specification/versions/candidate_release.md +++ b/specification/versions/candidate_release.md @@ -1,6 +1,6 @@ ## Version -v1.0 Candidate Release +v1.2 Candidate Release | ⚡ Warning | |:-------------------------------------------------------------------------------| diff --git a/specification/versions/main.md b/specification/versions/main.md index abf1c7eff..1ba30a72d 100644 --- a/specification/versions/main.md +++ b/specification/versions/main.md @@ -1,6 +1,6 @@ ## Version -Publication version 1.0 +Publication version 1.2 Copyright © 2024 - FinOps Open Cost and Usage Specification (FOCUS) a Series of the Joint Development Foundation Projects, LLC. Linux Foundation [trademark](https://www.linuxfoundation.org/legal/trademarks), and document use rules apply.