Improve the documentation

[albertattard]

Improve the documentation

1. Replace the deprecated goals with the recommended alternatives
2. Updates the dependencies to the latest versions
3. Includes further examples to make it clear where the changes needs to be made
4. Fix some minor issues

[oracle-contributor-agreement]

Thank you for your pull request and welcome to our community! To contribute, please sign the Oracle Contributor Agreement (OCA).
The following contributors of this PR have not signed the OCA:

• PR author: @albertattard

To sign the OCA, please create an Oracle account and sign the OCA in Oracle's Contributor Agreement Application.

When signing the OCA, please provide your GitHub username. After signing the OCA and getting an OCA approval from Oracle, this PR will be automatically updated.

If you are an Oracle employee, please make sure that you are a member of the main Oracle GitHub organization, and your membership in this organization is public.

[olyagpl]

By convention, paths to files, directories and file names should be italicized. These are not code blocks or commands. It's better to revert to _ name _ everywhere, for consistency with our documentation.

[melix]

LGTM! Did you check that the new instructions with updated plugin versions actually work?

[albertattard]

@melix, yes I tested the code as shown in the updated version and it works. I've updated the native tests command and included the -Dagent as this was missing. In such case, the tests will only work if the agent is enabled in the pom.xml.