Dev content review 1

[gkwan-ibm]

• [x] remove the following lines

  :page-essential: true
  :page-essential-order: 1

• [x] Title change to "Creating asynchronous reactive microservices using MicroProfile Reactive Messaging"
• [x] Make the short description same at the summary page and in the guide content, suggest following:
  • "Learn how to use MicroProfile Reactive Messaging to implement reactive architectured application."
• [x] Keep to use term "MicroProfile Reactive Messaging" (capital R and M) consistently in the guide.
• [x] Keep to use terms consistently in the guide.
  • order microservice
  • bar microservice
  • kitchen microservice
  • servingWindow microservice
  • restaurantBFF microservice (or restaurantBFF service?)
• What you’ll learn
  • [x] "The Reactive Restaurant application mentioned below is designed on Microservices architecture." change to
  • "The Restaurant application is designed with Reactive Architecture."
  • [x] "Producer and Consumer" Suggest to explain both terms in the "What is Kafka?" subsection
• Creating a reactive messaging application
  • [x] format the java files without wrapped lines at the right code pane
  • [x] Suggest the section structure
  • Creating the Restaurant application
    • Key concepts
    • Building the order microservice
    • [x] Start from "Navigate to the start directory to begin ..."
    • [x] tell readers that most code are provided, the following instructions will highlight the code to use MicroProfile Reactive Messaging
    • [x] suggest to explain the flow and highlight what is changed in this microservice and individual methods
    • Building the kitchen microservice
      • [x] suggest to explain the flow and highlight what is changed in this microservice and individual methods
    • Building the bar microservice
      • [x] suggest to explain the flow and highlight what is changed in this microservice and individual methods
    • Building the servingWindow microservice
      • [x] suggest to explain the flow and highlight what is changed in this microservice and individual methods
    • Configuring the MicroProfile Reactive Messaging
      • [x] explain the key properties
• Configuring the server
  • [x] Liberty -> Open Liberty
  • [x] Under Replace command, need to explain and highlight what is changed
  • [x] "The configuration ..." not clear
  • [ ] should not use microprofile-reactive-messaging-api in pom.xml, use microprofile 3.2
  • [x] make sure the pom.xml use minimal set of dependencies
• Building and running the application
  • [x] remove the clean from the mvn commands
  • [x] suggest "Run the following commands to build and containerize the application:" to "Run the following commands to containerize the microservices:"
  • [x] add a statement that the Dockerfile files are provided
  • [ ] can & be used on all platforms?
  • [x] for Win, shoud be startContainers.bat
  • [x] no need to have the following statement
  • "The Open Liberty server was started in development mode ..."
  • [x] both statements can be combined
  • "The services take some time ..."
  • "Check out the service that ..."
  • [x] "Click Execute again..." -> "Wait for a few second, then click Execute ..."
  • [x] Suggest the try out instructions can be separated to another sections like
  • Building the application
  • Trying the application
    • Place orders
    • Check orders status
    • Check ready orders
    • Complete an order
• Testing the service
  • need to investigate whether should have this section or not
• [x] Add a link to the offical MicroProfile Reactive Messaging Specification in somewhere
• [ ] Go ahead to create draft-guide-microprofile-reactive-messaging repo and move the master of this repo to dev branch of the draft-guide-microprofile-reactive-messaging repo

[ankitagrawa]

• [ ] can & be used on all platforms? Not sure
  • [ ] Go ahead to create draft-guide-microprofile-reactive-messaging repo and move the master of this repo to dev branch of the draft-guide-microprofile-reactive-messaging repo - needs to be done
  • [ ] should not use microprofile-reactive-messaging-api in pom.xml, use microprofile 3.2