atrium
atrium copied to clipboard
update to new dokka plugin
Non-Code related feature
Atrium is currently using dokka 0.9.8 via the tutteli-dokka plugin. We would like to update to dokka 1.4.10
Following the things we need to do (see https://github.com/robstoll/atrium/pull/683 most likely you can build on this):
- [ ] remove
classpath "ch.tutteli:tutteli-gradle-dokka:$tutteli_plugins_version"
from build.gradle - [ ] configure the new dokka plugin instead. You don't have to bother what was configured before, you can start from scratch but we have the following requirements:
- [ ] we need only the html report (disable the rest)
- [ ] make sure it is not included in the normal build (./gradlew build should not trigger it) - might be this is already the case. Use
./gradlew atrium-core-api-jvm:build --dry-run
and check if dokka is included. If it is, then find ways to deactivate it. We want to be able to run dokka separately - [ ] check if the samples for toBe are correctly rendered
- [ ] we still want an overall report when running ghPages. You probably need to adapt gradle/scripts/gh-pages.gradle => see https://github.com/Kotlin/dokka/blob/master/runners/gradle-plugin/MIGRATION.md and https://github.com/Kotlin/dokka#multi-module-projects => make sure we still suppress the packages defined at the end of the gh-pages.gradle script.
Hint, the following might help to setup the plugin, note thought that Atrium is using groovy and not kotlin for gradle https://github.com/Kotlin/dokka#using-dokka
Your first contribution?
- Write a comment
I'll work on this
if you would like to take this issue over. This way we get the chance to revise the description in case things have changed in the meantime, we might give you additional hints and we can assign the task to you, so that others do not start as well. - See Your first code contribution for guidelines.
- Do not hesitate to ask questions here or to contact us via Atrium's slack channel if you need help (Invite yourself in case you do not have an account yet).
I'll work on this
fixed with #1386