Difference between revisions of "Introduction"

From OOModels
Jump to navigationJump to search
Line 112: Line 112:
Simply click the download manager on each artefact page and select from the options.
Simply click the download manager on each artefact page and select from the options.


To learn more about the conversion mechanism and how you can contribute your
To learn more about how the conversion mechanism works and how you can contribute your
own converter, please refer to the [[Roadmap]].
own converter, please refer to the [[ArtefactConversion]] page.


===Get Started===
===Get Started===

Revision as of 12:30, 9 June 2008

oomodels.org is an open library of modelling artefacts from the business and technical domain.

The artefacts stored in oomodels shall be

  • open - see Philosophy
  • quality assured - see Quality
  • from the business domain
  • from the technical domain
  • human readable
  • human editable
  • machine readable

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: every company and person is invited to present himself in the same and fair manner (i.e., same amount of information, alphabetical ordering and alike). We do not consider commercialism as evil.

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 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]

Two 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 download manager.

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 wiki -- 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 namepsace.

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 working with, for or using 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 astandard.

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]

Find[edit]

Integrate[edit]

Learn[edit]