Igallizugaro website review

ROADMAP.md

@@ -1,21 +1,3 @@
 # 2024 CDM Roadmap from FINOS, ICMA, ISDA, & ISLA
 
-![](.github/cdm-roadmap-2024-1.png)
-
-![](.github/cdm-roadmap-2024-2.png)
-
-# 2024-5 Release schedule
-![CDM Release Guidelines Task Force Summary - July 2 2024](https://github.com/finos/common-domain-model/assets/7291088/9542593d-b63e-4447-8a21-cfec1df65221)
-
-Release States
-===============
-Release states are defined as follows:
-* Development – versions that include new designs from the “main” branch that are still under development.  All tests must pass but the model may continue to evolve before being released into production.
-* Production - the "latest and greatest" stable version that ideally everyone should upgrade to, and where enhancements compatible with the existing models will be included. We should aim for a release to be in Production for around a year if we can, to alleviate upgrade costs to consumers. 
-* Maintenance – when a new Production version is released then the current Production will go into Maintenance. Only critical bug fixes and changes related to critical regulatory requirements should be ported to Maintenance releases. Otherwise, functional changes would not be ported to maintenance releases.  The intention would be to have only 1 version at a time in maintenance, so each time a new Production version drops, the previous Maintenance release would go to Unsupported.
-* Unsupported/End of Life – There will be no bug fixes or other support for the version.  TBD: We may perform security scans on some more recent unsupported versions and report any identified vulnerabilities, but will not perform security remediations.
-
-
-At any point we want a maximum of 1 centrally supported development version, 1 production version, and one maintenance version.
-
-
+Please refer to the [Roadmap](docs/roadmap.mdx) page. 

SCOPE.md

@@ -1,5 +1,3 @@
 # Scope
 
-The Common Domain Model (CDM) is a standardised, machine-readable and machine-executable blueprint for how financial products are traded and managed across the transaction lifecycle. It is represented as a domain model and distributed in open source.
-
-There are no patents involved in the CDM.
+Please refer to the [CDM Overview page](docs/cdm-overview.md#scope)

docs/CDM-Collateral-WG.md

@@ -14,14 +14,13 @@ The Collateral Working Group plays a pivotal role in the CDM ecosystem by provid
 
 **Join us on the last Tuesday every month 10AM EST (3PM GMT).** Email [email protected] to be added to the meeting invites directly, or find the meeting in the [FINOS Community Calendar](https://calendar.google.com/calendar/embed?src=finos.org_fac8mo1rfc6ehscg0d80fi8jig%40group.calendar.google.com). 
 
-## 2024 Roadmap
-
-![Collateral WG Roadmap](/img/crwg-roadmap.png)
 
 ## Subscribe
 
-To subscribe to the [collateral workin group mailing list](https://lists.finos.org/g/cdm-collateral-wg) and stay updated on meetings and agenda, please send an email to [[email protected]](mailto:[email protected]). After sending the email, you will receive a confirmation message. Reply to confirm your subscription.
+To subscribe to the [collateral working group mailing list](https://lists.finos.org/g/cdm-collateral-wg) and stay updated on meetings and agenda, please send an email to [[email protected]](mailto:[email protected]). After sending the email, you will receive a confirmation message. Reply to confirm your subscription.
 
 ---
 
 To view meeting notes and agendas, view our [current](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+%22CDM+Collateral+Working+Group%22+is%3Aopen) and [past](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+%22CDM+Collateral+Working+Group%22+is%3Aclosed) GitHub Meeting Issues. 
+
+Click [here](working-groups.md) to return back to the Working Groups home page.

docs/CDM-Contribution-Review-WG.md

@@ -4,7 +4,7 @@ title: CDM Contribution Review Working Group
 
 ## Overview
 
-The CDM Contribution Review Working Group (CRWG) plays a crucial role in the CDM ecosystem. We review, approve, and implement contribution proposals to the CDM, ensuring the integrity and quality of the project. Additionally, we serve as arbitrators for any disputes arising from contributions, and we uphold the design principles and guidelines that govern the CDM.
+The CDM Contribution Review Working Group (CRWG) plays a crucial role in the CDM ecosystem. We [review](maintenance-and-release.md), approve, and implement [contribution](contributions.md) proposals to the CDM, ensuring the integrity and quality of the project. Additionally, we serve as arbitrators for any disputes arising from contributions, and we uphold the [design principles](design-principles.md), [change control guidelines](change-control-guidelines.md) and the [documentation style guidelines](documentation-style-guide.md) that govern the CDM.
 
 ### Responsibilities
 
@@ -18,9 +18,6 @@ The CDM Contribution Review Working Group (CRWG) plays a crucial role in the CDM
 
 **Join us on the First and Third Tuesday at 10 AM EST (3 PM GMT).** Email [email protected] to be added to the meeting invites directly, or find the meeting in the [FINOS Community Calendar](https://calendar.google.com/calendar/embed?src=finos.org_fac8mo1rfc6ehscg0d80fi8jig%40group.calendar.google.com). 
 
-## 2024 Roadmap
-
-![CRWG Roadmap](/img/crwg-roadmap.png)
 
 ## Subscribe
 
@@ -29,3 +26,5 @@ To subscribe to the CRWG mailing list and stay updated on meetings and agenda, p
 ---
 
 To view meeting notes and agendas, view our [current](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+is%3Aopen+%22CDM+Contribution+Review+Working+Group%22) and [past](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+%22CDM+Contribution+Review+Working+Group%22+is%3Aclosed) GitHub Meeting Issues. 
+
+Click [here](working-groups.md) to return back to the Working Groups home page.

docs/CDM-Derivatives-Product-and-Business-Event-WG.md

@@ -10,9 +10,6 @@ Focused on swaps (IR, credit, equity, commodity, etc.), options, FX, post-trade
 
 **Join us on the Second and Last Wednesday at 11:30 AM EST (4:30PM GMT).** Email [email protected] to be added to the meeting invites directly, or find the meeting in the [FINOS Community Calendar](https://calendar.google.com/calendar/embed?src=finos.org_fac8mo1rfc6ehscg0d80fi8jig%40group.calendar.google.com). 
 
-## 2024 Roadmap
-
-![DPBE Roadmap](/img/dpbe-roadmap.png)
 
 ## Subscribe
 
@@ -21,3 +18,5 @@ To subscribe to the [DPBE mailing list](https://lists.finos.org/g/cdm-dpbe-wg) a
 ---
 
 To view meeting notes and agendas, view our [current](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+is%3Aopen+%22CDM+Contribution+Review+Working+Group%22) and [past](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+%22CDM+Derivatives+Products+and+Business+Events+Working+Group%22+is%3Aclosed) GitHub Meeting Issues. 
+
+Click [here](working-groups.md) to return back to the Working Groups home page.

docs/CDM-Steering-WG.md

@@ -4,23 +4,23 @@ title: CDM Steering Working Group
 
 ## Overview
 
-This working group serves as the driving force behind the strategic direction and technical aspects of the CDM. We are responsible for establishing technical and modeling guidelines, setting and revising the project’s strategic roadmap, and vetting proposed changes. Additionally, we approve or establish additional working groups to address specific needs within the CDM ecosystem.
+The Steering Working Group serves as the driving force behind the strategic direction and technical aspects of the CDM. It is responsible for developing the technical and modelling guidelines, setting and revising the project’s strategic roadmap, and for vetting proposed changes. The CDM Steering Working Group may approve or establish additional working groups. 
+
 
 ### Responsibilities:
 
-- Define and monitor the overall roadmap, setting annual priorities.
+- Define and monitor the overall [roadmap](roadmap.mdx), setting annual priorities in line with the [development approach](development-approach.md). Guidelines for how to complete this can be found in the [major release scheduling guidelines](major-release-scheduling-guidelines.md) page
 - Decide on support for resourcing initiatives proposed by other working groups (TAWG, CRWG, or DWGs).
-- Approve new FINOS Working Groups (WGs).
+- Approve new FINOS [Working Groups](cdm-org-structure.md).
 - Determine matters of Governance & Operating Model for FINOS CDM WGs.
-- Provide final release approval.
+- Provide final [release](maintenance-and-release.md) approval.
+- The first Steering Group of each calendar year will include a review of existing [governance](governance.md) measures and wording on the agenda for re-ratification.
+
 
 ## Meetings
 
 **Join us Monthly on the Second Tuesday 11AM EST (4 PM GMT).** Email [email protected] to be added to the meeting invites directly, or find the meeting in the [FINOS Community Calendar](https://calendar.google.com/calendar/embed?src=finos.org_fac8mo1rfc6ehscg0d80fi8jig%40group.calendar.google.com). 
 
-## 2024 Roadmap
-
-![Steering WG Roadmap](/img/steering-roadmap.png)
 
 ## Subscribe
 
@@ -30,3 +30,5 @@ To subscribe to the [Steering Working Group mailing list](https://lists.finos.or
 
 To view meeting notes and agendas, view our [current](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+%22CDM+Steering+Working+Group+-+%22+is%3Aopen+) and [past](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+%22CDM+Steering+Working+Group+-+%22+is%3Aclosed) GitHub Meeting Issues. 
 
+Click [here](working-groups.md) to return back to the Working Groups home page.
+

docs/CDM-Structured-Products-WG.md

@@ -17,3 +17,5 @@ To subscribe to the [Structured Products WG mailing list](https://lists.finos.or
 ---
 
 To view meeting notes and agendas, view our [current](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+%22CDM+Structured+Products+Working+Group+-+%22+is%3Aopen) and [past](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+%22CDM+Structured+Products+Working+Group+-+%22+is%3Aclosed) GitHub Meeting Issues. 
+
+Click [here](working-groups.md) to return back to the Working Groups home page.

docs/CDM-Technology-Architecture-WG.md

@@ -4,21 +4,18 @@ title: CDM Technology Architecture Working Group
 
 ## Overview
 
-The CDM Technology Architecture Working Group focuses on aligning the architecture, tooling services, infrastructure, development practices, and deployment of the CDM with both existing and future technologies.
+The CDM Technology Architecture [Working Group](cdm-org-structure.md) focuses on aligning the architecture, tooling services, infrastructure, development practices, and deployment of the CDM with both existing and future technologies by leveraging [Rune](https://github.com/finos/rune-dsl/blob/main/README.md). Please note, Rune is currently being mantained and developed by the relevant Rune Working Groups to which the Technology Architecture Working Group provides input to. 
 
 ### Responsibilities
 
 - Defining and working on technical aspects and architecture-related items, such as language distributions, packaging, libraries, serialization, reference data architecture, and integration with other data standards.
-- Collaborating closely with the CDM Contribution Review Working Group. 
+- Collaborating closely with the [CDM Contribution Review Working Group](CDM-Contribution-Review-WG.md). 
 - Meeting monthly, with the flexibility to form sub-groups as necessary to address specific technical challenges or opportunities.
 
 ## Meetings
 
 **Join us every 2nd Thursday of Every Month, 9AM EST (2PM GMT).** Email [email protected] to be added to the meeting invites directly, or find the meeting in the [FINOS Community Calendar](https://calendar.google.com/calendar/embed?src=finos.org_fac8mo1rfc6ehscg0d80fi8jig%40group.calendar.google.com). 
 
-## 2024 Roadmap
-
-![TAWG Roadmap](/img/tawg-roadmap.png)
 
 ## Subscribe
 
@@ -28,3 +25,6 @@ To subscribe to the [TAWG mailing list](https://lists.finos.org/g/cdm-technology
 
 To view meeting notes and agendas, view our [current](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+%22CDM+Technology+Architecture+Working+Group+-+%22+is%3Aopen+) and [past](https://github.com/finos/common-domain-model/issues?q=is%3Aissue+%22CDM+Technology+Architecture+Working+Group+-+%22+is%3Aclosed) GitHub Meeting Issues. 
 
+Click [here](working-groups.md) to return back to the Working Groups home page.
+
+Click [here](cdm-org-structure.md) to review the CDM organisational structure. 

LICENSE.md → docs/LICENSE.md

@@ -96,4 +96,4 @@ This patent licensing commitment does not apply to those claims subject to Contr
 
 *The text of this Community Specification License is Copyright 2020 Joint Development Foundation and is licensed under the Creative Commons Attribution 4.0 International License available at https://creativecommons.org/licenses/by/4.0/.*
 
-SPDX-License-Identifier: CC-BY-4.0
+SPDX-License-Identifier: CC-BY-4.0

docs/cdm-org-structure.md

@@ -0,0 +1,7 @@
+## CDM Organisational Structure
+
+The below diagram illustrates the organization of the CDM working groups.
+
+![](../.github/Group-Roles-Scope.png)
+Click [here](governance.md) to return to the Governance page.
+Click [here](working-groups.md) to return the Working Groups home page. 

docs/cdm-overview.md

@@ -15,11 +15,11 @@ and machine-executable blueprint for how financial products are traded
 and managed across the transaction lifecycle. It is represented as a
 [domain model](https://olegchursin.medium.com/a-brief-introduction-to-domain-modeling-862a30b38353) and distributed in open source.
 
-For an overview of the Common Domain Model, a comparative analysis with FpML, an exploration of the CDM's historical development and events, as well as insights into its further applications, including its role in the ecosystem and support for smart contract technology, we recommend reviewing the [CDM Overview deck](/pdfs/CDM-Overview.pdf). 
+For an overview of the Common Domain Model, a comparative analysis with FpML, an exploration of the CDM's historical development and events, as well as insights into its further applications, including its role in the ecosystem and support for smart contract technology, we recommend reviewing the CDM Overview deck.
 
 ISDA’s Digital Regulatory Reporting (DRR) solution leverages the open-source Common Domain Model (CDM) to convert industry-agreed interpretations of new or amended regulatory reporting rules into clear, machine-executable code. This approach enhances implementation efficiency and reduces costs. Institutions contributing to the development of the ISDA DRR include (but are not limited to) those listed on [ISDA’s Digital Regulatory Reporting Page](https://www.isda.org/isda-digital-regulatory-reporting/).
 
-ISDA has also launched the Get Started with the CDM for Collateral Guide! You can now access a wealth of resources and tutorials on CDM for collateral management on the [CDM-Collateral Initiatives page](https://www.isda.org/2023/02/16/isda-collateral-initiatives/).
+ISDA has also launched Get Started guides for the CDM for Collateral and Digital Regulatory Reporting.  You can access these [here](https://www.isda.org/isda-solutions-infohub/cdm/).
 
 If you’re interested in the Common Domain Model (CDM), please complete the [CDM Interest Form](https://www.finos.org/common-domain-model) to join our mailing list. By signing up, you’ll receive updates on CDM initiatives, meeting agendas, and other working group activities.
 
@@ -46,10 +46,18 @@ For further information about the CDM and its applications, please
 consult the [CDM section](https://www.finos.org/common-domain-model) of the FINOS website or contact FINOS directly
 at <[email protected]>.
 
+## Model Overview 
+The key models defined in the CDM are listed below. Click each one to learn more. 
+- [Product model](product-model.md) -  describes a thing (e.g. contract or instrument) that is used to transfer financial risk between two parties.
+- [Event model](event-model.md) - provides data structures to represent the lifecycle events of financial transactions.
+- [Process model](process-model.md) - lays the foundation for the standardisation, automation and inter-operability of industry processes.
+- [Reference data model](reference-data-model.md) – describes underlying business entities such as parties, legal entities, floating rate indexes, and so on that needed to model the in-scope products, events, legal agreements and function components.
+- [Use cases](use-cases.md) – business process areas in the financial ecosystem that the CDM supports.
+
 ## Design Principles
 
-To support these objectives, the CDM is built according to a set of
-design principles that include the following concepts:
+To support the objectives described above, the CDM is built according to a set of
+[design principles](design-principles.md) that include the following concepts:
 
 -   **Normalisation** through abstraction of common components
 -   **Composability** where objects are composed and qualified from the
@@ -59,25 +67,28 @@ design principles that include the following concepts:
 -   **Modularisation** into logical layers
 
 These design principles are further detailed in the
-[design-principles](#design-principles) section of the CDM
+[design principles](design-principles.md) section of the CDM
 documentation.
 
 ## Governance
 
-The CDM [governance framework](contribution#governance) regulates
+The CDM [governance framework](governance.md) regulates
 the development of the CDM in open source.
 
+A diagram outlining the groups involved can be found [here](cdm-org-structure.md)
+
 ## Scope
 
-The CDM covers OTC derivatives, cash securities, securities financing, commodities, and can expand to include other Capital Markets products and Asset Classes.
+The Common Domain Model (CDM) is a standardised, machine-readable and machine-executable blueprint for how financial products are traded and managed across the transaction lifecycle. It is represented as a domain model and distributed in open source, covering OTC derivatives, cash securities, securities financing, commodities. It can expand to include other Capital Markets products and Asset Classes. 
+
+There are no patents involved in the CDM.
 
 ## CDM 2024 Roadmap
 Below is the full roadmap as ratified by the Steering WG in Jan 2024, subject to change as priorities evolve.
-![](/img/cdm-roadmap-2024-2.png)
-![](/img/cdm-roadmap-2024-1.png)
 
-- The latest CDM roadmap of expected contributions sponsored by the presently participating trade associations: ICMA, ISDA and ISLA can be found under [Roadmap.md](https://github.com/finos/common-domain-model/blob/master/ROADMAP.md) . 
-- Releases can be tracked on the [CDM Releases](https://github.com/finos/common-domain-model/releases/) page.
+The latest CDM roadmap of expected contributions sponsored by the presently participating trade associations: ICMA, ISDA and ISLA can be found [here](roadmap.mdx)
+
+Releases can be tracked on the [CDM Releases](https://github.com/finos/common-domain-model/releases/) page.
 
 # CDM Components
 
@@ -88,7 +99,7 @@ CDM components diagram below:
 -   The Rune DSL (on the left, in *grey*)
 -   CDM Applications (on the right, in *blue*)
 
-![](/img/cdm-components-diagram.png)
+![](img/cdm-components-diagram.png)
 
 ## FINOS CDM Distribution
 
@@ -100,10 +111,9 @@ The FINOS CDM distribution comprises three main sets of components:
 
 -   **Model definition**, which corresponds to the model as expressed in
     the Rune DSL and contained into a set of *.rosetta* files
-    organised as *namespaces*. The primary dimensions of the model are
+    organised as [*namespaces*](namespace.md). The primary dimensions of the model are
     listed below and further described in the
-    [common-domain-model](/docs/common-domain-model) of the
-    documentation.
+    [above](cdm-overview.md/#Model-Overview).
     -   Product
     -   Event
     -   Legal Agreement
@@ -191,5 +201,5 @@ repository using the repository settings contained in the `settings.xml`
 file in the CDM jar.
 
 For more details, please follow the
-[CDM Java Distribution Guidelines](/docs/cdm-guidelines).
+[CDM Java Usage](java-usage.md).