From a4134c5adbff6286c0816066c7c58fbdf29a292e Mon Sep 17 00:00:00 2001 From: Lars <57503246+larsk21@users.noreply.github.com> Date: Fri, 4 Aug 2023 10:26:52 +0200 Subject: [PATCH 1/3] Update README.md --- README.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 55b3d62e5..21393cc0e 100644 --- a/README.md +++ b/README.md @@ -4,17 +4,24 @@ [![Issues](https://img.shields.io/github/issues/vitruv-tools/Vitruv.svg)](https://github.com/vitruv-tools/Vitruv/issues) [![License](https://img.shields.io/github/license/vitruv-tools/Vitruv.svg)](https://raw.githubusercontent.com/vitruv-tools/Vitruv/main/LICENSE) -[Vitruvius](https://vitruv.tools) is a framework for view-based software development. It assumes different models to be used for describing a software system, -which are automatically kept consistent by the framework and its applications. For general information on Vitruvius, see our [GitHub Organisation](https://github.com/vitruv-tools) and our [Wiki](https://github.com/vitruv-tools/.github/wiki). +[Vitruvius](https://vitruv.tools) is a framework for view-based software development. +It assumes different models to be used for describing a software system, which are automatically kept consistent by the framework executing (semi-)automated rules that preserve consistency. +These models are modified only via views, which are projections from the underlying models. +For general information on Vitruvius, see our [GitHub Organisation](https://github.com/vitruv-tools) and our [Wiki](https://github.com/vitruv-tools/.github/wiki). -This project contains the central definition of a V-SUM (Virtual Single Underlying Model) containing development artifacts to be kept consistent and to be accessed and modified via views. +This project contains the central Vitruvius framework, providing the definition of a V-SUM (Virtual Single Underlying Model) containing development artifacts to be kept consistent and to be accessed and modified via views. +In the implementation, a V-SUM is called `VirtualModel`, which is instantiated with a set of `ChangePropagationSpecifications` (no matter whether they are developed with the [Vitruv-DSLs](https://github.com/vitruv-tools/Vitruv-DSLs) or just as an implementation of the interface defined in the [Vitruv-Change](https://github.com/vitruv-tools/Vitruv-Change) repository). +The `VirtualModel` then provides functionality to derive and modify views and to propagate the changes in these views back to the `VirtualModel`, which then executes the `ChangePropagationSpecifications` to preserve consistency. ## Installation -Vitruvius can be installed in Eclipse via the [nightly update site](https://vitruv.tools/updatesite/nightly). A wiki page provides [detailed instructions for using or extending Vitruvius](https://github.com/vitruv-tools/.github/wiki/Getting-Started). +Vitruvius can be installed in Eclipse via the [nightly update site](https://vitruv.tools/updatesite/nightly). A wiki page provides [detailed instructions for using or extending Vitruvius or parts of it](https://github.com/vitruv-tools/.github/wiki/Getting-Started). ## Project Development Vitruvius is realized as Eclipse plug-ins and depends on the following Eclipse tools: - Eclipse Modeling Framework (EMF) _as the modelling environment_ - Xtend _for code_ + +This project depends on the following other Vitruvius projects: +- [Vitruv-Change](https://github.com/vitruv-tools/Vitruv-Change) From e2e9b21d9dab542e7e93dd6c0bfc75c57a3d85f3 Mon Sep 17 00:00:00 2001 From: Lars <57503246+larsk21@users.noreply.github.com> Date: Fri, 4 Aug 2023 10:44:57 +0200 Subject: [PATCH 2/3] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 21393cc0e..960f605af 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,8 @@ [![Issues](https://img.shields.io/github/issues/vitruv-tools/Vitruv.svg)](https://github.com/vitruv-tools/Vitruv/issues) [![License](https://img.shields.io/github/license/vitruv-tools/Vitruv.svg)](https://raw.githubusercontent.com/vitruv-tools/Vitruv/main/LICENSE) -[Vitruvius](https://vitruv.tools) is a framework for view-based software development. -It assumes different models to be used for describing a software system, which are automatically kept consistent by the framework executing (semi-)automated rules that preserve consistency. +[Vitruvius](https://vitruv.tools) is a framework for view-based (software) development. +It assumes different models to be used for describing a system, which are automatically kept consistent by the framework executing (semi-)automated rules that preserve consistency. These models are modified only via views, which are projections from the underlying models. For general information on Vitruvius, see our [GitHub Organisation](https://github.com/vitruv-tools) and our [Wiki](https://github.com/vitruv-tools/.github/wiki). From 4a8ea92334ee72fed2567c7d368672b0100e394f Mon Sep 17 00:00:00 2001 From: Lars <57503246+larsk21@users.noreply.github.com> Date: Fri, 4 Aug 2023 13:05:11 +0200 Subject: [PATCH 3/3] Update README.md --- README.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 960f605af..3cfe44de3 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Vitruv V-SUM +# Vitruv [![GitHub Action CI](https://github.com/vitruv-tools/Vitruv/actions/workflows/ci.yml/badge.svg)](https://github.com/vitruv-tools/Vitruv/actions/workflows/ci.yml) [![Latest Release](https://img.shields.io/github/release/vitruv-tools/Vitruv.svg)](https://github.com/vitruv-tools/Vitruv/releases/latest) [![Issues](https://img.shields.io/github/issues/vitruv-tools/Vitruv.svg)](https://github.com/vitruv-tools/Vitruv/issues) @@ -17,11 +17,7 @@ The `VirtualModel` then provides functionality to derive and modify views and to Vitruvius can be installed in Eclipse via the [nightly update site](https://vitruv.tools/updatesite/nightly). A wiki page provides [detailed instructions for using or extending Vitruvius or parts of it](https://github.com/vitruv-tools/.github/wiki/Getting-Started). -## Project Development +## Framework-internal Dependencies -Vitruvius is realized as Eclipse plug-ins and depends on the following Eclipse tools: -- Eclipse Modeling Framework (EMF) _as the modelling environment_ -- Xtend _for code_ - -This project depends on the following other Vitruvius projects: +This project depends on the following other projects from the Vitruvius framework: - [Vitruv-Change](https://github.com/vitruv-tools/Vitruv-Change)