Migrate from docbook to asciidoctor [SPR-10960]

[spring-projects-issues]

Rob Winch opened SPR-10960 and commented

---

Sub-tasks:

• Polish asciidoctor [SPR-11096] #15722 Polish asciidoctor

Issue Links:

• INT-3197 Migrate from Docbook to Asciidoctor

Referenced from: commits dcc6ef2, 3476d11, fd0b6ca, 7bf4324

[spring-projects-issues]

Rob Winch commented

Pull request #1 provides a good basis for this #377

[spring-projects-issues]

Rob Winch commented

Pull request #2 provides a different approach to our basis for this #378

[spring-projects-issues]

Brian Clozel commented

I've pushed a couple of things on a branch for PR #378; might interest you: https://github.com/bclozel/spring-framework/commits/docbookxr (building docs using a gradle task, a couple of fixes on include directives). This PR will be updated because it looks the gradle plugin can be upgraded.

[spring-projects-issues]

Rob Winch commented

Thanks for the fixes Brian Clozel. One thing to note is that the current plugin doesn't support PDF. If this is something we want, we will need to either wait until I integrate support into the plugin or place the code into the buildSrc of Spring Framework as I did with Spring Security.

I will wait to merge your updates in until I address the issue (probably a little over a week) or if Phil Webb is taking over this (since he assigned it to himself) he can merge the changes in when he gets to it.

[spring-projects-issues]

Phil Webb commented

Rob Winch sorry, the reassign was habit when I targeted it to RC 2. Happy to take it on after RC1 if needed. I feel quite strongly that this one is well worth the effort of getting in.

Brian Clozel I have merged or closed outstanding documentation PRs.

[spring-projects-issues]

Rob Winch commented

Phil WebbNo problem....just wasn't sure if you were volunteering or not. If it is still sitting when I get time in a little over a week I will take this on.

[spring-projects-issues]

Rob Winch commented

I have a pull request available here #395

[spring-projects-issues]

Rob Winch commented

This is now complete see http://docs.spring.io/autorepo/docs/spring-framework/4.0.0.BUILD-SNAPSHOT/spring-framework-reference/htmlsingle/

To get started documenting see https://github.com/spring-projects/spring-framework/blob/master/CONTRIBUTING-DOCUMENTATION.adoc

NOTE We are still waiting on a PR for spring.io to update the link to the new docs

[spring-projects-issues]

Rob Winch commented

One last thing to note is I logged a JIRA for the default styling of asciidoctor to deal with the line through the authors here asciidoctor/asciidoctor#774