Spring Cloud DataFlow documentation has missing sections - spring

I am reading right now the Spring Cloud DataFlow documentation, but it turn out that the sections contained in PART IV (Modules) has some kind of error, because the whole section is fill up with this kind of text
Unresolved directive in raw.githubusercontent.com/spring-cloud/spring-cloud-stream-modules/master/
spring-cloud-stream-modules-docs/src/main/asciidoc/sinks.adoc - include::{repo-root}/cassandra-sink/
README.adoc[tags=ref-doc]
There is any way to access to this documentation?
Is Spring XD Documentation Module section a sustitution for my problem?, Spring Cloud DataFlow modules work the same way that Spring XD, so I can use Spring XD documentation instead?
Thanks for your time

Thanks for reporting.
We are getting ready for the M3 release of Spring Cloud Data Flow and the docs are actively being restructured right now. We will get this cleaned up very soon.
In the meantime, please feel to review each application level READMEs from the app-starter repo. Here's an example for cassandra-sink.

Related

Why that Spring Framework Documentation's table of contents is gone?

I remember there was a table of contents in the document before but now is gone.
That makes it inconvenient to find the specified chapter.
And I see the other's project still has the table of contents.
Is it something wrong with this doc page?
Spring Framework Documentation:
https://docs.spring.io/spring-framework/docs/current/reference/html/core.html
And others project like Spring Boot :
https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features
I have the same symptoms, but with Spring Framework project, not Spring Boot. I managed to download PDF versions of the topics. They're at:
https://docs.spring.io/spring-framework/docs/5.3.9/reference/pdf/core.pdf
https://docs.spring.io/spring-framework/docs/5.3.9/reference/pdf/testing.pdf
https://docs.spring.io/spring-framework/docs/5.3.9/reference/pdf/data-access.pdf
https://docs.spring.io/spring-framework/docs/5.3.9/reference/pdf/web.pdf
https://docs.spring.io/spring-framework/docs/5.3.9/reference/pdf/web-reactive.pdf
https://docs.spring.io/spring-framework/docs/5.3.9/reference/pdf/integration.pdf
https://docs.spring.io/spring-framework/docs/5.3.9/reference/pdf/languages.pdf
https://docs.spring.io/spring-framework/docs/5.3.9/reference/pdf/appendix.pdf
Both links lead to Spring features

the spring boot oauth2 doc teaches deprecated annotation?

it's a confusing problem but suffered me several days.
Firstly, I got to know that the new spring security oauth2 is changed, then I come to learn:https://docs.spring.io/spring-security-oauth2-boot/docs/2.5.2/reference/html5/.
However, when I try to add the annotation #EnableAuthorizationServer to the "main method", the Intellij throws it's deprecated".
Then, I tried to check the version: springframework.boot:2.5.2 , spring-security-oauth2:2.5.1.RELEASE, spring-security-oauth2-autoconfigure:2.5.2.
It means all the dependencies are new, and the doc is new too.
Then why the Intellij says the annotation is deprecated? I just wanna follow the new trend. Please tell me what to do?
thanks a lot.
As the documentation to which you have linked states, the project is in maintenance mode. Where possible, it should not be used and the equivalent features in Spring Security 5.x should be used instead.
The deprecation message on EnableAuthorizationServer links to a migration guide. From there you can learn about the Spring Authorization Server project which you may want to use.

What's the difference between 'com.microsoft.azure' and 'com.azure'?

When creating a new Spring Boot project using Spring Initializr and adding Azure Support, it adds a dependency to com.microsoft.azure:azure-spring-boot-starter.
implementation 'com.microsoft.azure:azure-spring-boot-starter'
The spring cloud documentation says:
The Azure Support entry contains auto-configuration support for Azure
managed services [...]
Now I'd like to send and receive messages from Azure Service Bus and the documentation wants me to add a dependency to azure-servicebus.
implementation 'com.microsoft.azure:azure-spring-boot-starter'
implementation 'com.microsoft.azure:azure-servicebus'
Okay fine. When I now switch over to Microsoft and read the documentation about Service Bus there, it mentions two libraries, where Microsoft states the second one is dated and legacy.
azure-messaging-servicebus (latest) implementation 'com.azure:azure-messaging-servicebus:7.0.0'
azure-servicebus (legacy) 'com.microsoft.azure:azure-servicebus'
Question
Is the Spring Boot documentation just outdated?
I have read somewhere that libraries in com.microsoft.com are for managing the resource itself, while libraries in com.azure are for managing the data. Is this true?
What is meant by auto-configuration support?
As you can see I am very confused which dependencies I need to add. Also I don't get the difference between packages from com.azure and com.microsoft.azure.
Can someone please shed some light on this?

Spring Gemfire Cache implementation

I am trying to implement cache mechanism provide by Spring Data GemFire. Has anyone implemented a solution? I need to check on performance and ease to implement it.
Sonal-
First, you can find plenty of examples in the Spring User Guides, here, for example...
Accessing Data with GemFire,
Caching Data with GemFire, and ...
Accessing GemFire Data with REST
Additionally, there is a Spring GemFire Examples project here.
I have also started work on building a "Reference Implementation" (RI) for Spring Data GemFire/Geode, here. I have much work to do with this project yet, like documentation (READMEs) in the Repo, but I do plan to keep it up-to-date with my latest developments since I use the code as a basis for all my conference talks. Anyway, there is plenty of code examples and tests in this GitHub project to keep you busy for awhile.
Then, the Spring Data GemFire and Spring Data Geode GitHub projects themselves, have plenty of tests to show you how to address different application concerns (Configuration, Data Access, Function Execution, etc, etc).
Of particular interests might be the new Annotation-based configuration model for SDG^2 that I am working on. This is currently a WIP and I am also working on User Guide documentation for this feature/functionality, but it is established and even inspired by the auto-configuration features and Annotations provided by Spring and Spring Boot (e.g. #EnableXYZ).
Users have even started using the Annotation-based configuration model without significant documentation in place since it builds on concepts already available and familiar in Spring Boot. In fact combining these SDG specific Annotations with Spring Boot makes for a very powerful combination while preserving simple/easy nature to get started, 1 of my primary goals.
Given the lack of documentation yet, you can find more out in the Spring IO blog, where I first blogged about it here. Then I expanded on this article in a second blog, talking specifically about security.
And if you are really curious, you can follow the latest developments of the Annotation configuration model in my testing efforts.
Finally, of course, as I have already alluded to, as any good developer knows, getting started is as easy following the examples and reviewing Spring Data GemFire Reference Guide and Javadoc.
Don't forget to familiarize yourself with Pivotal GemFire as well! Javadoc here.
Hope this helps!
-John

How to report/fix Spring framework documentation issues

I found few typos/mistakes in Spring Boot reference guide.
Could you please suggest whom can I contact, or even better how to fix it myself (e.g via pull request if possible) ?
I checked spring GitHub repository but spring-boot-actuator-docs seems to have nothing to do with reference guide.
Thanks in advance.
Spring Boot is like any regular github project. It is located here:
https://github.com/spring-projects/spring-boot
If you want to fix the typos, create a pull request. You'll find all you need to know in our contributing page. The documentation is located in the spring-boot-docs module

Resources