The purpose of this Web site is to enable the AIXM community to collaboratively develop guidance material in support to the AIXM implementations and to provide information about such implementations. Three high-level areas of interest are identified: data sources, coding guidelines and extensions. In order to facilitate contributions from the global AIXM community, anonymous users are allowed to provide comments on certain sections of the Web site. Registered users have the possibility to make both inline and global comments and can also contribute to the development of the site.
Will be added progressively!
The AIXM Confluence site is organised in "Spaces", each dedicated to a specific topic or sub-topic. Each space is a collection of pages, organised as a tree. A page may have other child pages.
There are two ways of providing comments to the content.
Comment field: In case you have a general comment relevant for the whole content of a page, please enter it comment in corresponding field displayed at the bottom of each page and save it. This way of commenting allows some additional formatting (e.g. text colouring, italic, bold, etc.) and for named users also some additional functions (e.g. upload of images).
Please note that comment fields remain visible even once the comment was resolved. Therefore,the preferred commenting method is to use inline comments, which may be resolved and closed.
You can also edit your already saved comments.
When commenting as anonymous user you may add at the beginning of the comment your name. This could help the content contributors to address the comment in the best way. Of course, you are not obliged to provide your name.
For some pages, a workflow is implemented in order to allow for reviewing the page content before making it publicly available. First a content page is in the draft status, then it should be assigned for review and finally it will be published.
There are two main types of users. Based on the type of the user, different access permissions are granted.
The following four types of mark-up are used on some pages in order to draw the attention of the reader on some particular aspects:
This mark-up is s used to create awareness for a matter of specific importance. A Note may be editorial or content related.
|Used to highlight issues such as inconsistencies detected in source documents, limitations of the AIXM model, etc. In general, an issue will require an action to be taken, such as bringing the issue to the attention of the AIXM Change Control Board, etc.|
This mark-up is used, for example, when providing coding examples or information about other resources that might complement the information provided on the page.
This mark-up is used to mark open questions which the author of the content is not able to resolve using the input available. It is possible that some open questions remain on the site for a long time. For example, open questions concerning elements that might be candidates for inclusion in the AIP data set might remain for a long time in this status. They might be resolved when sufficient experience is accumulated and a solution emerges.
On some pages (such as the pages where the AIXM model elements are explained) an SBVR-style formatting is used as defined in the document
AIXM 5.1 - Business Rules - Using SBVR and Schematron, version 0.7
The main formats used are:
Contributors (i.e. named users) when providing content can format text according the SBVR style. Therefor dedicated text formatting styles have been created which can be selected in the edit mode from the tool bar.
SBVR NounConcept : CTRL+SHIFT+1
SBVR Verb-concept : CTRL+SHIFT+2
SBVR 'Name' : CTRL+SHIFT+3
SBVR keyword : CTRL+SHIFT+4