New Documentable build broken

[coke]

3 points:

1. can no longer use 'make' to build the docs; after looking ...

2. I followed the directions in the README, I don't have documentable installed; so I tried to add it to the META6.json and then install it with zef install --deps-only ., but:

3. Can't install it because one of the downstream deps fails. Opened a ticket in both Documentable and Pod::To::Cached where the actual failure is.

Raku/Documentable#29

[JJ]

1. Make is no longer used to build the docs, documentable is.
2. Will check that out.
3. Thanks!

[coke]

Make was just a wrapper for htmlify before. My suggestion would be to do the same with the new script.

…

On Mon, Sep 2, 2019 at 02:08 Juan Julián Merelo Guervós < ***@***.***> wrote: 1. Make is no longer used to build the docs, documentable is. 2. Will check that out. 3. Thanks! — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#2998>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAAMIUNDIX2FADYGH6NZS7DQHSUUZANCNFSM4ISYIDHA> .

[JJ]

There's a difference, though; before, htmlify.p6 was in the same repository; you need to install documentable now. Also, before the only option was make html, and now there's a different command if you want to generate the initial cache and all the html files or if you just want to update what's changed.
Will see the best way to do this, though...

[coke]

Once the META6.json deps are updated properly, doesn't matter that the script is coming from somewhere else. the same make command can be used to do the new build, and a new "update" task could be added for the other option.

[JJ]

Well, I'm kind of wary of adding Documentable to the dependencies for the time being, and maybe in the future. All tools for building the documentation are going to be spun off eventually, with dependencies on this module and documentable. Main point is that documentation is documentation. Tooling should be developed, and used, from somewhere else. Spinning off documentable is the first step, the roadmap is open for comments in #2983

[JJ]

Documentable now has been reported to work by the OP and others. so I'm closing this issue.