spring-cloud-samples/spring-cloud-contract-samples

Workshop is not consistent

paul-ovchinnikov opened this issue · 5 comments

I spent 2 days to go through the simplest examples. The reason for this is that the description and code examples do not match. The workshop samples code also does not match the documentation. I will not give specific examples, there are many of them. Just try out a few lessons yourself.

producer_with_restdoc sample, .pom file assembly plugin adding.
documentation sample:

<configuration>
    <attach>true</attach>
    <descriptor>${basedir}/src/assembly/stub.xml</descriptor>
</configuration>

missing <descriptors> tag
There are a lot of such stupid mistakes in workshop

Spring Cloud Contract with Rest Docs Workshop:

  • Writing Your First Rest Docs Test - fails due to AssertJ incompatible version
  • Generating Tests from Contracts - does not generate anything under /target/generated-test-sources
  • Reading HTTP Stubs from the Classpath with Spring Cloud Contract WireMock - ApplicationContext failed
    So this chapter of workshop is fully unuseful

Thanks for the info

Are you willing to file a PR to help?

We're no longer supporting the workshops.