OT Failures

[kirkilj]

Hi Jason,

The README states that "The DITA-OT Swagger plug-in has been tested against DITA-OT 3.x.

However, your mentioning how to install DITA 4.0 in the next few paragraphs.

Ever since we upgraded our Docker image to use Java 11 and OT 3.7.4, any use of a topicref with format="swagger" fails. It's been running just fine for a couple years prior to that.

Are there any other compatibility issues which we should be aware of? It looks like you updated some dependencies recently, so were they related to compatibility with DITA 4.x? We plan to move to 4.1 in our next release of our internal pipeline, but for the moment we're running on 3.7.4.

I noticed that you made changes last week to some dependencies, but you haven't issued a new release.

[jason-fox]

The plugin is was originally written and should work with DITA-OT 3.x - that is part of the original README.

The plugin is regularly updated to run against latest DITA-OT. So far it is usually just the tests and test dependencies that have needed to be updated - for example when a PanDoc release alters the HTML. Since I'm only testing this against latest DITA-OT 4.x I would always recommend that version.

Since I'm not regularly re-testing against DITA-OT 3.x I couldn't guarantee against regression errors, but the best formatting will occur with a 4.x engine.