Merge branch 'main' into release/1.1.0

CONTRIBUTING → CONTRIBUTING.md

@@ -11,25 +11,21 @@ middleware that integrates traditional production systems (e.g. PLC controllers)
 and state-of-the art IT technology (BPMN engine, SOA) to enable next generation
 of production automation.
 
-* https://projects.eclipse.org/projects/technology.basyx
+* https://projects.eclipse.org/projects/dt.basyx
 
 ## Developer resources
 
 Information regarding source code management, builds, coding standards, and
 more.
 
-* https://projects.eclipse.org/projects/technology.basyx/developer
+* https://projects.eclipse.org/projects/dt.basyx/developer
 
 The project maintains the following source code repositories
 
-* https://git.eclipse.org/r/plugins/gitiles/basyx/basyx
-* https://git.eclipse.org/r/plugins/gitiles/basyx/basyx.website
+* https://github.com/eclipse-basyx
 
-This project uses Bugzilla to track ongoing development and issues.
-
-* Search for issues: https://bugs.eclipse.org/bugs/buglist.cgi?product=Basyx
-* Create a new report:
-   https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Basyx
+This project uses GitHub to track ongoing development and issues.
+* To open an issue for this project open the [issues](https://github.com/eclipse-basyx/basyx-java-sdk/issues) tab
 
 Be sure to search for existing bugs before you create another one. Remember that
 contributions are always welcome!

README.md

@@ -1,10 +1,31 @@
-# Eclipse BaSyx JAVA SDK
+# Eclipse BaSyx Java SDK
+[![BaSyx Logo](https://www.eclipse.org/basyx/img/basyxlogo.png)](https://www.eclipse.org/basyx/)
 
-The Eclipse BaSyx project provides a wiki: https://wiki.eclipse.org/BaSyx
+The Eclipse BaSyx Java SDK is part of the [Eclipse BaSyx middleware](https://www.eclipse.org/basyx/). The SDK has been created within the [BaSys](https://www.basys40.de/) project.
 
-For install information, see https://wiki.eclipse.org/BaSyx_/_Download
-There are introductory examples provided by https://wiki.eclipse.org/BaSyx_/_Introductory_Examples
-Additionally, the API is described in https://wiki.eclipse.org/BaSyx_/_Documentation_/_API
-If you would like to contribute, the overall process is described in https://wiki.eclipse.org/BaSyx_/_Developer_/_Contributing
+## Eclipse Wiki
+A detailed technical and user documentation can be found in the [Eclipse BaSyx wiki](https://wiki.eclipse.org/BaSyx). For the Java SDK, you can find instructions about [how to install](https://wiki.eclipse.org/BaSyx_/_Download_/_Java_Setup) and find [introductory](https://wiki.eclipse.org/BaSyx_/_Introductory_Examples) and [extended](https://wiki.eclipse.org/BaSyx_/_Examples) code examples and further [scenarios](https://wiki.eclipse.org/BaSyx_/_Scenarios). Also, see the description of the individual [components and their API](https://wiki.eclipse.org/BaSyx_/_Documentation_/_API).
 
-This project migrated from the Eclipse infrastructure. For the archived history, see https://git.eclipse.org/r/basyx/basyx
+## Blog posts
+
+For further information, you may also read the blog posts about the Industrie 4.0 IT Infrastructure for Digital Twins:
+- Part 1 - [Building the Industry 4.0 IT Infrastructure for Digital Twins](https://www.iese.fraunhofer.de/blog/industry-4-0-it-infrastructure-for-digital-twins/)
+- Part 2 - [Implementing the Industrie 4.0 IT Infrastructure for Digital Twins](https://www.iese.fraunhofer.de/blog/industrie-4-0-it-infrastructure-for-digital-twins-part2/).
+
+## Video documentation
+
+Additionally, you can also find videos explaining the BaSyx middleware on youtube:
+
+[![BaSyx-Middleware – easily explained with the model factory](http://img.youtube.com/vi/bMY8FLhjjRI/mqdefault.jpg)](http://www.youtube.com/watch?v=bMY8FLhjjRI)
+
+*BaSyx-Middleware – easily explained with the model factory*
+
+[![How to make Industrie 4.0 easy with our BaSyx middleware](http://img.youtube.com/vi/kx2F5E5foLU/mqdefault.jpg)](http://www.youtube.com/watch?v=kx2F5E5foLU)
+
+*How to make Industrie 4.0 easy with our BaSyx middleware*
+
+## Contributing
+
+If you would like to contribute, please notice the [contribution guidelines](CONTRIBUTING.md). The overall process is described in the [Eclipse wiki](https://wiki.eclipse.org/BaSyx_/_Developer_/_Contributing).
+
+This GitHub project is migrated from the Eclipse infrastructure. For the archived history, see the [previous repository](https://git.eclipse.org/c/basyx/basyx.git/).