Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Table of Contents

...

Introduction

Interoperability defined

Interoperability is understood in different ways depending on the specification under consideration:

...

When you are developing an implementation, make sure that you have a clear understanding of the specification of the protocol and the artefact. The specification should be precise enough to ensure that your implementation is interoperable with others or is at least very close to be. In case of questions, do not consciously make assumptions but contact the writer of the specification. Interoperability is primarily a matter of correct and consensual interpretation of this specification.

Taking responsibility

Be aware that it is not always clear which aspects of interoperability fall under the specification writers responsibility, and which fall under the implementation developers responsibility. Too often interoperability problems arise when each party is over-reliant on the other party to ensure interoperability.

Guidelines

Defined behavior after errors

Define the behavior of your implementation in case of errors. 

The next type of errors should be taken into consideration:

  • the errors from "Errors" section of the specification, mainly concerning the protocol
  • errors after reception of faulty artefacts from another implementation
  • errors when processing correct artefacts by your implementation
  • errors during generation of faulty artefacts by your implementation

Used version of the specification




...

Requirements

This paragraph should be moved to the requirements documentation.

...