Improve documentation

[Stwissel]

The official site can use more examples and explanations

[charles-thompson-salesforce-com]

This is a great project, @[Stephan Wissel]​ . Thanks for posting.

In the interest of completeness, and assistance to others like me that are new to Vert.X, it might be a good idea to include some basics (such as links to things like "What is Vert.X & Verticles?" and "Set up Vert.x on Heroku") in your site (https://stwissel.github.io/vertx-sfdc-platformevents/).

I can help, if you like. I think this concept is very good for customers looking for more from their event bus, or alternatives to expensive ESBs and integration platforms like Mulesoft and Tibco. Secure access to Salesforce data & events is the link that makes it worth investigating.

To make this tool relevant to business users, it might be a good idea to build out the example to show this solution in context of an end-to-end business process. Here's an example using the common sales process of producing an official quotation from an external CPQ engine:

1. In Salesforce, end users build up the Opportunity using Products & Price Books
2. User clicks an action button to generate a quote
3. Event is sent to the bus
4. Picked up by a listener for the CPQ system
5. CPQ does its thing and produces the quote as a PDF
6. CPQ posts it on the bus
7. Picked up by Salesforce Listener Verticle which posts it to the Opportunity (and optionally emails or otherwise notifies the end user)