Skip to content

REF-25: Remove stale LBSB examples; convert docs to markdown - #53

Open
thomasnymand wants to merge 1 commit into
masterfrom
feature/REF-25-remove-lbsb
Open

REF-25: Remove stale LBSB examples; convert docs to markdown#53
thomasnymand wants to merge 1 commit into
masterfrom
feature/REF-25-remove-lbsb

Conversation

@thomasnymand

Copy link
Copy Markdown
Collaborator

REF-25

Why

LBSB (Liberty Basic SOAP Binding) was the first profile this library implemented; OIO IDWS SOAP superseded it. The examples/lbsb/ tree is a near-duplicate of examples/oio-idws-soap/ that only adds the retired urn:liberty:sb framework header. Its shared classes (e.g. DigstSTSClient) are byte-identical to the SOAP ones, it points at the decommissioned ADFS STS (sts cert expired 2020), it has no integration tests, and no real code change since 2021.

Changes

  • Remove examples/lbsb/ (5 modules) and drop <module>lbsb</module> from examples/pom.xml. Reactor still builds — verified with mvn clean install -DskipTests on JDK 8 (20 modules, BUILD SUCCESS).
  • Remove docs/traces/lbsb/ (captured LBSB message traces).
  • Convert docs to markdown. The docs use the LBSB document as the primary reference and describe OIO IDWS as a delta on it, so the content must be preserved. Every .docx in docs/ is converted to GitHub-flavoured markdown under a new doc/ folder (pandoc), with embedded media extracted per document. The .docx originals are retained for now.
markdown (in doc/) source
nemlog-in2-lbsb-scenarios.md NemLog-in2 - LBSB Scenarios.docx
nemlog-in2-oio-idws-1.1-scenarios.md NemLog-in2 - OIO IDWS 1.1 Scenarios.docx
nemlog-in2-oio-idws-rest-scenarios.md NemLog-in2 - OIO IDWS REST Scenarios.docx
healthcare-oio-idws-xua-scenarios.md Healthcare - OIO IDWS XUA Scenarios.docx
cxf-and-ws-securitypolicy.md CXF and WS-SecurityPolicy.docx

Known limitation

3 Word diagrams are EMF and won't render on GitHub (no EMF→PNG/SVG converter was available on the build host). Flagged as a follow-up — they can be re-exported as PNG/SVG later.

Notes

  • net cross-stack examples and all OIO IDWS SOAP/REST scenarios are unaffected.
  • The LBSB documentation is intentionally kept (as markdown) since OIO IDWS is described relative to it.

LBSB (Liberty Basic SOAP Binding) was the first profile this library
implemented; OIO IDWS SOAP later superseded it. The LBSB examples are a
near-duplicate of oio-idws-soap that only add the retired urn:liberty:sb
framework header, point at the decommissioned ADFS STS (sts cert expired
2020), have no integration tests, and have had no real code change since
2021.

- Remove examples/lbsb/ and drop the <module>lbsb</module> from
  examples/pom.xml. Reactor still builds (verified, JDK 8).
- Remove docs/traces/lbsb/ (captured LBSB message traces).
- Because the docs use the LBSB document as the primary reference and
  describe OIO IDWS as a delta on it, convert every docx in docs/ to
  GitHub-flavoured markdown under a new doc/ folder (pandoc), with
  embedded media extracted per document. The docx originals are retained
  for now.

Known limitation: 3 Word diagrams are EMF and won't render on GitHub;
no EMF->PNG/SVG converter was available. Flagged for follow-up.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant