Hi everyone,
It has been quiet for a while, so I wanted to share a small sneak preview of the next DocInsight update.
The upcoming version has been moving to a new project foundation, including a new docinsight.json manifest and a first Markdown-based documentation workflow. The goal is to make DocInsight projects easier to configure, easier to build locally, and more suitable for mixed documentation sets such as guides, developer notes, and API references.
Here is an early preview of a DocInsight-generated documentation site:
This example uses DPM as an unofficial showcase project. The site combines Markdown guide pages with generated reference-style navigation, search, page outline, and a clean local HTML output.
A simplified project manifest now looks more like this:
{
"project": {
"name": "dpm",
"title": "DPM"
},
"sources": {
"main": {
"type": "delphi",
"files": [
"Source/dpm.dproj"
],
"options": {
"compiler": "delphi_13",
"platform": "Win32"
}
}
},
"content": {
"guide": {
"title": "Guide",
"type": "markdown",
"root": "docs/guide",
"mount": "/"
},
"dev": {
"title": "Dev Guide",
"type": "markdown",
"root": "docs/dev"
},
"code": {
"title": "Code Reference",
"type": "delphi",
"source": "main"
}
},
"output": {
"targets": {
"site": {
"type": "html",
"path": "dist/docs/site",
"content": [
"guide",
"dev",
"code"
]
}
}
}
}
There is still more work before release, and some details may change, but the next version is actively being prepared.
More updates soon.