Web lists-archives.com

Q: Packaging wiki documentation.




Dear list,

I'm considering packaging OpenCPN[1]. It's mostly straight-forward, but
the documentation seems problematic.

The docs are basicallly a wiki based on DocuWiki [2]. As part of the
release process the site is exported and html and PDF files in the git
tree is updated. This is a manual process which relies on administrative
privileges to the docuwiki instance.

After pushing the generated docs through the packaging toolchain lintian
rightfully complains about missing sources - in this case, the wiki
markdown files.

I have no experience in the docuwiki tool. At a glance, already getting
the markdown sources seems non-obvious. Even if I had the sources, I see
no path to rebuild the docs as part of a package build process.

Is there any experience out there in this situation? Or just some thoughts?

Cheers!
--alec

[1]  https://github.com/OpenCPN/OpenCPN
[2]  https://www.dokuwiki.org/