For the Job DSL Plugin [1] we use the Conflunce wiki page only for a summary and some basic information. For all other documentation we point to the GitHub wiki [2]. The wiki content is kept in the repo [3], so contributors can/must update the docs as part of a pull request. To update the wiki we use the ghpages Gradle plugin [4], which can be configured to update the wiki [5].
So far users seem to find the relevant docs and there have been no complaints. Merging/rebasing the docs has not been more or less painful than merging code. Daniel [1] https://wiki.jenkins-ci.org/display/JENKINS/Job+DSL+Plugin [2] https://github.com/jenkinsci/job-dsl-plugin/wiki [3] https://github.com/jenkinsci/job-dsl-plugin/tree/master/docs [4] https://github.com/ajoberstar/gradle-git/wiki/org.ajoberstar.github-pages [5] https://github.com/jenkinsci/job-dsl-plugin/blob/master/build.gradle#L139 -- You received this message because you are subscribed to the Google Groups "Jenkins Developers" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/jenkinsci-dev/c97c4487-0e94-4ef2-bca9-2ee0c05456ee%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
