Refactoring SDPi to Address Emerging Complexity Issues
@PaulMartinsen is already working on this.
Since Jul 31, 2026.
- Dominant language
- Kotlin
- Stars
- 17
- Forks
- 4
- PR merge metrics
- No merged PRs in 30d
Description
As the SDPi standard has evolved, especially leveraging the rich metadata that is central to this profile standard, there is also an increasing degree of complexity in authoring the context, making maintenance and authoring more challenging and limiting those who can actively contribute.
Options should be explored for potentially refactoring the content so as to help reduce the inherent complexity while maintaining the technical elements of the specification.
One option is converting the current AsciiDoc-based specification to using "Typist". The rationale for this, from @d-gregorczyk is:
Typst, it is very similar to Asciidoc. What Asciidoc lacks, comes with Typst:
- fully specified
- tons of tutorials and modules
- default export to PDF and HTML, both fully customizable
- incremental builds with blazingly fast instant previews in editors such as VSCode and IntelliJ
- based on a script language that allows to specify Turing-complete functions (which means: one tools fits all, no AsciidoctorJ+Kotlin anymore)
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.