Provide getting started with release trains mapping to Spring Boot generation

[snicoll]

I am working with the Wavefront team (Hi @shavidissa) on improving their getting started documentation for the Spring Boot starter. The starter has optional support for tracing via Sleuth so we need to tell users how they can include that in their existing project.

The doc sandbox is here. We're considering reusing this section of the project's page.

I'd like as much as possible to not include too much information for existing projects. Each release announcement has a section that describes how to get started for both Maven and Gradle.

Would it be possible to get a page somewhere that summarises all that, that is:

• Build instructions to get started
• Mapping between Spring Cloud release train and Spring Boot generation

In an ideal world, rather than the name of the release train, it would be very nice to get the actual version that we have to use (latest service release or milestone, depending on the situation).

Thanks!

[ryanjbaxter]

Mapping between Spring Cloud release train and Spring Boot generation

This would be possible to retrieve programmatically using https://spring-cloud-info.cfapps.io/docs/spring-cloud-info.html#_spring_cloud_version_given_spring_boot_version

I wonder if we could make a page that would allow the user to either pick the Boot version or Cloud version and then automatically generate the Maven and Gradle getting started info.

Would that help @snicoll?

[snicoll]

This would be possible to retrieve programmatically using https://spring-cloud-info.cfapps.io/docs/spring-cloud-info.html#_spring_cloud_version_given_spring_boot_version

I had forgotten about that one!

I wonder if we could make a page that would allow the user to either pick the Boot version or Cloud version and then automatically generate the Maven and Gradle getting started info.

Yeah that would be more than ideal of course!

[shavidissa]

Thank you, @snicoll and @ryanjbaxter!

This would be possible to retrieve programmatically using https://spring-cloud-info.cfapps.io/docs/spring-cloud-info.html#_spring_cloud_version_given_spring_boot_version

This is cool! I will use this :)

I wonder if we could make a page that would allow the user to either pick the Boot version or Cloud version and then automatically generate the Maven and Gradle getting started info.

Yeah that would be more than ideal of course!

This would be great for Spring Cloud and all the other dependencies in spring.io. It will make it easier for the user to get this info in one place. As Stéphane showed, I think this information is already captured in https://start.spring.io/actuator/info.

[ryanjbaxter]

@shavidissa

This is cool! I will use this :)

So does that get you what you need? Or is there still missing information?

[snicoll]

@ryanjbaxter No. The endpoint doesn't provide what was requested in the original description, specifically

Would it be possible to get a page somewhere that summarises all that, that is:

* Build instructions to get started
* Mapping between Spring Cloud release train and Spring Boot generation

[ryanjbaxter]

@snicoll I have updated the page, please let me know what you think!

[snicoll]

Thanks @ryanjbaxter. Just to make sure I got this right, you mean https://spring.io/projects/spring-cloud#getting-started right?

[ryanjbaxter]

@snicoll yup!

[shavidissa]

Hi @ryanjbaxter,

Thanks a lot! This is much better and user friendly. We have it in our Wavefront docs :)

[snicoll]

Looks good indeed, I think this can be closed. Thanks a lot for the quick turnaround!

[ryanjbaxter]

Great thanks!