Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation - Enhancement Readme #126

Open
wants to merge 10 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 60 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
# SIRI (Service Interface for Real-time Information)
## Overview

- SIRI (Service Interface for Real-Time Information) XML schema is a standardized format for exchanging real-time information about public transportation services and events.

## Folder structure 📁

More information on the folders' structure can be found in the [wiki](https://github.com/ITxPT/SIRI/wiki/Structure-%26-Compatibility/#folders)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should become part of this repo.


## UML model

- You can refer to the SIRI UML model for a detailed UML view of the schema packages.
- The SIRI UML model is available in electronic format.

## Getting started 🚀
### Main Root Schemas

**siri.xsd**

- Defines the SIRI XML model elements and attributes that are used to exchange public transport information.
- Supports both request/response and publish/subscribe communication patterns.
- Used by a wide range of public transport operators and service providers.

**siri_all_functionalServices.xsd**

- Imports all the SIRI functional service schemas.
- Provides a convenient way to access all the SIRI functionality in a single schema.
- Can be used to develop applications that support all SIRI services.

**siriSg.xsd**

- Defines additional SIRI XML model elements and attributes that are used by some SIRI services.
- For example, the siriSg.xsd schema defines elements for exchanging vehicle location and status information, as well as stop monitoring information.
- Can be used to develop applications that support advanced SIRI features.

### XML examples

- Explore XML examples in the */examples* subdirectory.

Further information on the examples is available on the [wiki](https://github.com/ITxPT/SIRI/wiki/Using-SIRI#how-to-use-example-files)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be part of this repo.


### Support for XML editors

- **Altova XMLSpy Project**: Find an organized view of the schema and examples in the root directory.
- Project file: Siri.spp
- **Oxygen Project File:**
- Project file: Siri.xpr

More information on the tools available for working with SIRI XML schema can be found in the [wiki](https://github.com/ITxPT/SIRI/wiki/Software-&-tools)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be part of this repo.


## Releases

| Release Number | Release Date | Summary of Changes |
|----------------|--------------|----------------------------|
| v2.1 | Oct 2002 | [Latest](https://github.com/SIRI-CEN/SIRI/releases/tag/v2.1) |
| v2.0 | May 2015 | Bug fixes and updates |
| v1.4a | April 2011 | Minor corrections |
| v1.3 | March 2009 | Corrections and revisions |

Changes to the SIRI schema from v1.3 and up to v2.0 are available in [release-notes](release-notes) folder