refs #176

[noma4i]

Add valuable information which is hidden in the pile of issues

[palazzem]

Hello @noma4i and thanks for this suggestion! Actually we describe the Tracer configuration in this section: http://gems.datadoghq.com/trace/docs/#Configure_the_tracer

Do you think it's better to state something in the Quickstart (integration) section? Maybe we can be a bit more explicit.

[noma4i]

@palazzem I know that yard docs contain that. On the other hand readme should contain base configuration suitable to jumpstart with. On/Off switch is valuable info. I think that it needs to be in readme as I came here accross issues and amount of people wondering how to disable tracer with new config is bigger then you think ;)

[palazzem]

Sure thing @noma4i ! consider that I'm collecting feedbacks to improve better our documentation. Let's keep it in the Quickstart section then.

[palazzem]

Since this is a quickstart and the default "expected behavior" is to have the tracer enabled (or at least we hope!), can we move this to a different section?

Before "To know if a given framework or lib is supported by our client, please consult our integrations list." we may add:

To configure the Datadog Tracer, you can define the `configure` block as follows:

Datadog.configure do |c|
  c.tracer enabled: false, hostname: 'trace-agent.local'
  # [...]
end

For a list of available options, check the [Tracer documentation](http://gems.datadoghq.com/trace/docs/#Configure_the_tracer).

What do you think?

[noma4i]

👍

[palazzem]

Nice! as soon you update the PR I'm going to merge it! thank you very much for pointing out this important issue about documentation!

[noma4i]

Iv pushed changes. Looks way better

[palazzem]

@noma4i thank you very much! going to merge that!