Update README based on customers' feedback (#1109)

* Update tracing code snippet.

* Fix a TODO.

* Explain why to set record events and sampler.

1 files changed, 9 insertions, 3 deletions

diff --git a/README.md b/README.md
index 317ce090..bdfc94d7 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@ project.
 
 Integrating OpenCensus with a new library means recording stats or traces and propagating context.
 
-TODO: add a link to Java quick start documentation on opencensus.io once it's ready.
+The full quick start example can also be found on the [OpenCensus website](https://opencensus.io/java.html).
 
 ### Add the dependencies to your project
 
@@ -50,8 +50,14 @@ public final class MyClassWithTracing {
   private static final Tracer tracer = Tracing.getTracer();
 
   public static void doWork() {
-    // Create a child Span of the current Span.
-    try (Scope ss = tracer.spanBuilder("MyChildWorkSpan").startScopedSpan()) {
+    // Create a child Span of the current Span. Always record events for this span and force it to 
+    // be sampled. This makes it easier to try out the example, but unless you have a clear use 
+    // case, you don't need to explicitly set record events or sampler.
+    try (Scope ss = 
+         tracer.spanBuilder("MyChildWorkSpan")
+           .setRecordEvents(true)
+           .setSampler(Samplers.alwaysSample())
+           .startScopedSpan()) {
       doInitialWork();
       tracer.getCurrentSpan().addAnnotation("Finished initial work");
       doFinalWork();