Difference between revisions of "Introduction"
AndreasLeue (talk | contribs) |
|||
(29 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
'''oomodels.org''' is an open library of modelling artefacts from the business and technical domain. | '''oomodels.org''' is an open library of object oriented modelling artefacts from the business and technical domain, offering open operational business knowledge. | ||
The artefacts stored in oomodels | The artefacts stored in oomodels are | ||
* ''open'' - see [[# | * ''open'' - see [[#Philosophy|Philosophy]] | ||
* ''quality assured'' - see [[# | * ''operational'' - provided in several formats ready for use in your model aware enterprise | ||
* ''from the business domain'' | * ''object oriented'' - basically that means: state of the art | ||
* ''from the technical domain'' | * ''quality assured'' - see [[#Quality|Quality]] | ||
* ''human readable'' | * ''from the business domain'' - get your industry specific models from here | ||
* ''human editable'' | * ''from the technical domain'' - get all that necessary infratructure stuff from here, too | ||
* ''machine readable'' | * ''human readable'' - i.e. at least xml, ideally well documented | ||
* ''human editable'' - easily editable with mediawikis editing capabilities | |||
* ''machine readable'' - readable by software due to structural and content constraints | |||
You can [[#Download|download]], [[#Contribute|contribute]], [[#Discuss|discuss]] and [[#Develop|develop]] modelling artefacts, [[#Meet|meet]] architects and software providers, [[#Convert|convert]] formats, [[#Get_Started|get started]] with your software solution, [[#Find|find]] software to operate your model, [[#Integrate|integrate]] with eclipse and [[#Learn|learn]] about formats, concepts and technologies. | You can [[#Download|download]], [[#Contribute|contribute]], [[#Discuss|discuss]] and [[#Develop|develop]] modelling artefacts, [[#Meet|meet]] architects and software providers, [[#Convert|convert]] formats, [[#Get_Started|get started]] with your software solution, [[#Find|find]] software to operate your model, [[#Integrate|integrate]] with eclipse and [[#Learn|learn]] about formats, concepts and technologies. | ||
Line 20: | Line 22: | ||
to keep the spirit and functioning of oomodels.org, e.g. correct annotations and alike. | to keep the spirit and functioning of oomodels.org, e.g. correct annotations and alike. | ||
''oomodels.org'' is not anti-commercial: every company and person is invited to present | ''oomodels.org'' is not anti-commercial or alike: every company and person is invited to present herself in the same | ||
and fair manner (i.e., same amount of information, alphabetical ordering and alike). We do not | and fair manner (i.e., same amount of information, alphabetical ordering and alike). We do not share any | ||
ideological opinions. | |||
The '''artefacts''' (i.e. models, classes, templates etc.) in oomodels shall be open/free in the sense that some | The '''artefacts''' (i.e. models, classes, templates etc.) in oomodels shall be open/free in the sense that some | ||
Line 31: | Line 33: | ||
fair presentation. | fair presentation. | ||
oomodels.org was initiated and is driven by [[Contact:Person/net/leue/andreas|Andreas Leue]]. I am open | oomodels.org was initiated and is currently mainly driven by [[Contact:Person/net/leue/andreas|Andreas Leue]]. | ||
to put this effort in the hands of some possibly better suited foundation. If anyone is willing to help | I am open to put this effort in the hands of some possibly better suited foundation. If anyone is willing to help | ||
me with his experience in doing so, you are very welcome to contact me. | me with his experience in doing so, you are very welcome to contact me. | ||
===Quality=== | ===Quality=== | ||
The combination of the ''wiki nature'' and the ''machine readbility'' influence the quality of artefacts within oomodels.org. | |||
First, the '''wiki nature''' enables collaboration, discussion and feedback related to artefacts. | First, the '''wiki nature''' enables collaboration, discussion and feedback related to artefacts. | ||
Line 49: | Line 51: | ||
===Download=== | ===Download=== | ||
Each artefact in oomodels.org provides a link to the [ | Each artefact in oomodels.org provides a link to the [[DownloadManager]]. You find this link on the right side in a box. There, you can get the code, which is automatically extracted from the wiki page and optionally converted into other formats. | ||
The download manager relies on correct annotations of the artefacts. Specifically, the type and encoding of artefacts are crucial. For an example, see [[Artefact:Model/org/oomodels/tests/models/basic/SimpleClass]]. | The download manager relies on correct annotations of the artefacts. Specifically, the type and encoding of artefacts are crucial. For an example, see [[Artefact:Model/org/oomodels/tests/models/basic/SimpleClass]]. | ||
Line 55: | Line 57: | ||
Then, in the download manager, you may choose from a variety of target formats you might wish the artefact to be converted to before downloading. | Then, in the download manager, you may choose from a variety of target formats you might wish the artefact to be converted to before downloading. | ||
I.e., this works if someone has [[#contribute|contributed]] a respective converter. See [[#contribute|Contribute]] for details. Or read the next section (hint, hint, hint ;-) ). | I.e., this works if someone has [[#contribute|contributed]] a respective [[ArtefactConversion|converter]]. See [[#contribute|Contribute]] for details. Or read the next section (hint, hint, hint ;-) ). | ||
===Contribute=== | ===Contribute=== | ||
Line 76: | Line 78: | ||
===Discuss=== | ===Discuss=== | ||
Each page in oomodels -- as is the case with any [http://www.mediawiki.org mediawiki | Each page in oomodels -- as is the case with any [http://www.mediawiki.org mediawiki] -- | ||
provides a discussion/talk page. There you can leave comments, make suggestions, | provides a discussion/talk page. There you can leave comments, make suggestions, | ||
exchange opinions with others without influencing the corresponding main page. | exchange opinions with others without influencing the corresponding main page. | ||
Line 91: | Line 93: | ||
You may want to use this to mature your own framework within your namespace, or you | You may want to use this to mature your own framework within your namespace, or you | ||
might want to participate to develop a common modelling groundwork as we intend to | might want to participate to develop a common modelling groundwork as we intend to | ||
do within the org/oomodels | do within the org/oomodels namespace. | ||
===Meet=== | ===Meet=== | ||
Line 97: | Line 99: | ||
Artefacts and formats might be linked with people or companies who have created them or who provide | Artefacts and formats might be linked with people or companies who have created them or who provide | ||
software to process them. There is a list of [[Contact:person|persons]] and [[Contact:company|companies]] | software to process them. There is a list of [[Contact:person|persons]] and [[Contact:company|companies]] | ||
who work with, work for or just use oomodels.org and it's content. | |||
You might want to get in touch with them - here's the opportunity. | You might want to get in touch with them - here's the opportunity. | ||
Line 105: | Line 107: | ||
Since there is no world-wide-agreed-upon modelling standard avaible yet, and | Since there is no world-wide-agreed-upon modelling standard avaible yet, and | ||
by far no such standard which allows modelling of ''complete, fully functional and production quality'' | by far no such standard which allows modelling of ''complete, fully functional and production quality'' | ||
applications, we cannot enforce such | applications, we cannot enforce such a standard. | ||
Therefore, we provide a conversion mechanism. It allows downloading of | Therefore, we provide a conversion mechanism. It allows downloading of | ||
Line 116: | Line 118: | ||
===Get Started=== | ===Get Started=== | ||
Up to now, building a real, individual enterprise solution offered you two | |||
alternatives: | |||
* ''highest flexibility, no domain knowledge'': building a new solution from scratch, using some framework, tool or whatsoever | |||
* ''few flexibility, lots of domain knowledge'': starting with an existing solution, and adopting it to your needs | |||
Both alternatives hurt. With oomodels.org, there is a third: | |||
* ''highest flexibility, lots of domain knowledge'': get your selection of models from oomodels.org directly into your workspace, and choose a framework you like to build the application with | |||
For eclipse, such a download-into-workspace-plugin is under development ([http://www.oomodels.org/updatesite Eclipse Update Site]). For other IDE's, feel | |||
free to contribute a respective extension. | |||
===Find=== | ===Find=== | ||
Associated with artefacts and formats, you may find people or companies offering services or solutions | |||
related to these artefacts. This may range from simple consultancy services up to a click-and-download-complete-solution feature. | |||
===Integrate=== | ===Integrate=== | ||
An eclipse-plugin to download oomodels.org-artefacts directly into your workspace is under development: [http://www.oomodels.org/updatesite Eclipse Update Site]. | |||
===Learn=== | ===Learn=== | ||
Since it's a wiki, there is much space for general information and accompanying | |||
articles related to the artefacts or simply related to oo modelling in general. | |||
In the [[Artefact:Document]] namespace is a place for storing general information. |
Latest revision as of 11:24, 17 November 2011
oomodels.org is an open library of object oriented modelling artefacts from the business and technical domain, offering open operational business knowledge.
The artefacts stored in oomodels are
- open - see Philosophy
- operational - provided in several formats ready for use in your model aware enterprise
- object oriented - basically that means: state of the art
- quality assured - see Quality
- from the business domain - get your industry specific models from here
- from the technical domain - get all that necessary infratructure stuff from here, too
- human readable - i.e. at least xml, ideally well documented
- human editable - easily editable with mediawikis editing capabilities
- machine readable - readable by software due to structural and content constraints
You can download, contribute, discuss and develop modelling artefacts, meet architects and software providers, convert formats, get started with your software solution, find software to operate your model, integrate with eclipse and learn about formats, concepts and technologies.
Philosophy[edit]
oomodels.org is open. That means, everyone can participate, contribute and benefit in the same manner.
Exceptions from the rule: we might eventually need protection against vandalism, and we might need moderation to keep the spirit and functioning of oomodels.org, e.g. correct annotations and alike.
oomodels.org is not anti-commercial or alike: every company and person is invited to present herself in the same and fair manner (i.e., same amount of information, alphabetical ordering and alike). We do not share any ideological opinions.
The artefacts (i.e. models, classes, templates etc.) in oomodels shall be open/free in the sense that some GPL-, CreativeCommons- or-a-like-license applies. If not stated otherwise, the creative commons license given on the bottom left of the page applies.
Software for processing these models need not be free or open. There is no restriction on this, except the fair presentation.
oomodels.org was initiated and is currently mainly driven by Andreas Leue. I am open to put this effort in the hands of some possibly better suited foundation. If anyone is willing to help me with his experience in doing so, you are very welcome to contact me.
Quality[edit]
The combination of the wiki nature and the machine readbility influence the quality of artefacts within oomodels.org.
First, the wiki nature enables collaboration, discussion and feedback related to artefacts. We can establish architect groups on oomodels.org who can officially approve certain artefacts and provide signed seals of approval.
Second, artefacts are machine readable. Use of the artefacts and conversion/download software will as a side effect increase their quality. As a coarse check, a robot might download and convert the artefacts routinely.
Download[edit]
Each artefact in oomodels.org provides a link to the DownloadManager. You find this link on the right side in a box. There, you can get the code, which is automatically extracted from the wiki page and optionally converted into other formats.
The download manager relies on correct annotations of the artefacts. Specifically, the type and encoding of artefacts are crucial. For an example, see Artefact:Model/org/oomodels/tests/models/basic/SimpleClass.
Then, in the download manager, you may choose from a variety of target formats you might wish the artefact to be converted to before downloading.
I.e., this works if someone has contributed a respective converter. See Contribute for details. Or read the next section (hint, hint, hint ;-) ).
Contribute[edit]
Be part of the creation of this powerful and valuable artefact resource!
Remember: the site is a wiki. Everyone can contribute to this resource.
If you're unsure how to edit in general, you may want to try the sandbox.
If you're unsure how to edit, annotate and organise your artefacts within oomodels.org,
- be sure to read the short introduction
- get an idea of using namespaces in the wiki
- find a suitable namespace you're in control of (e.g. com/example)
- and try experimenting within your own sandbox (e.g. com/example/sandbox)
E.g., your first model might be on the page Artefact:Model/com/example/sandbox/MyFirstModel.
Discuss[edit]
Each page in oomodels -- as is the case with any mediawiki -- provides a discussion/talk page. There you can leave comments, make suggestions, exchange opinions with others without influencing the corresponding main page.
Just click on the dicsussion tab on the top of the page.
Develop[edit]
The organisation of artefacts within well defined, globally unique namespaces, while at the same time within one easily accessible wiki with it's interlinking and discussion capabilities provides a nice framework to collaboratively develop models.
You may want to use this to mature your own framework within your namespace, or you might want to participate to develop a common modelling groundwork as we intend to do within the org/oomodels namespace.
Meet[edit]
Artefacts and formats might be linked with people or companies who have created them or who provide software to process them. There is a list of persons and companies who work with, work for or just use oomodels.org and it's content.
You might want to get in touch with them - here's the opportunity.
Convert[edit]
Since there is no world-wide-agreed-upon modelling standard avaible yet, and by far no such standard which allows modelling of complete, fully functional and production quality applications, we cannot enforce such a standard.
Therefore, we provide a conversion mechanism. It allows downloading of artefacts in several target formats, as is appropriate for your needs.
Simply click the download manager on each artefact page and select from the options.
To learn more about how the conversion mechanism works and how you can contribute your own converter, please refer to the ArtefactConversion page.
Get Started[edit]
Up to now, building a real, individual enterprise solution offered you two alternatives:
- highest flexibility, no domain knowledge: building a new solution from scratch, using some framework, tool or whatsoever
- few flexibility, lots of domain knowledge: starting with an existing solution, and adopting it to your needs
Both alternatives hurt. With oomodels.org, there is a third:
- highest flexibility, lots of domain knowledge: get your selection of models from oomodels.org directly into your workspace, and choose a framework you like to build the application with
For eclipse, such a download-into-workspace-plugin is under development (Eclipse Update Site). For other IDE's, feel free to contribute a respective extension.
Find[edit]
Associated with artefacts and formats, you may find people or companies offering services or solutions related to these artefacts. This may range from simple consultancy services up to a click-and-download-complete-solution feature.
Integrate[edit]
An eclipse-plugin to download oomodels.org-artefacts directly into your workspace is under development: Eclipse Update Site.
Learn[edit]
Since it's a wiki, there is much space for general information and accompanying articles related to the artefacts or simply related to oo modelling in general.
In the Artefact:Document namespace is a place for storing general information.