DocumenterMarkdown

[orenbenkiki]

The MadsPublish.jl imports DocumenterMarkdown, though it seems it doesn't use it. It generates the output in HTML format, which is already covered by format=Documenter.Writers.HTMLWriter; the DocumentedMarkdown allows generating Markdown output using format=DocumenterMarkdown.Markdown, which isn't used.

This wouldn't be a problem except that DocumenterMarkdown only works with pre-1.0 versions of Documenter, so installing Mads forces Documenter to an old version (0.27.25), which has an incompatible API with the 1.* Documenter versions, breaking anything that is using the latest (presumably stable?) Documenter 1.* API.

It also wouldn't have been a problem if DocumenterMarkdown was being updated, but according to JuliaDocs/DocumenterMarkdown.jl#11 it doesn't seem like this would be any time soon.

How about simply removing DocumenterMarkdown as a dependency of Mads?

[asinghvi17]

FYI there is JuliaDocs/DocumenterMarkdown#13 which will transition DocumenterMarkdown to v1 of Documenter. That should happen sometime this month.

[orenbenkiki]

Ugh, missed it. My bad.

Still - if DocumenterMarkdown isn't ever used, why make it a dependency and import it in the 1st place? Or am I missing something additional?

[montyvesselinov]

DocumenterMarkdown has been removed. I agree with your comments. We are working to compertamentalize the packages.