Fixes to tokens and traces (#200)

Author: tothmano

query-data/traces.mdx

@@ -81,6 +81,8 @@ In Axiom, trace events are just like any other events inside datasets. This mean
 
 To see how spans in a trace are related to each other, explore the trace in a waterfall view. In this view, each span in the trace is correlated with its parent and child spans.
 
+### Traces in OpenTelemetry Traces dashboard
+
 To explore spans within a trace using the OpenTelemetry Traces app, follow these steps:
 
 1. Click the `Dashboards` tab.
@@ -97,6 +99,8 @@ To try out this example, go to the Axiom Playground.
 
 [Run in Playground](https://play.axiom.co/axiom-play-qf1k/dashboards/otel.traces.otel-demo-traces)
 
+### Traces in Query tab
+
 To access the waterfall view from the Query tab, follow these steps:
 
 1. Ensure the dataset you work with has trace data.

reference/tokens.mdx

@@ -13,15 +13,15 @@ This reference article explains how you can authenticate your requests to the Ax
 You can use the Axiom API and CLI to programmatically ingest and query data, and manage settings and resources. For example, you can create new API tokens and change existing datasets with API requests. To prove that these requests come from you, you must include forms of authentication called tokens in your API requests. Axiom offers two types of tokens:
 
 - [API tokens](#api-tokens) let you control the actions that can be performed with the token. For example, you can specify that requests authenticated with a certain API token can only query data from a particular dataset.
-- [Personal access tokens (PATs)](#personal-access-tokens-pat) provide full control over your Axiom account. Requests authenticated with a PAT can perform every action you can perform in Axiom. When possible, avoid using PATs.
+- [Personal access tokens (PATs)](#personal-access-tokens-pat) provide full control over your Axiom account. Requests authenticated with a PAT can perform every action you can perform in Axiom. When possible, use API tokens instead of PATs.
 
 <Warning>
 Keep tokens confidential. Anyone with these forms of authentication can perform actions on your behalf such as sending data to your Axiom dataset.
 </Warning>
 
 When working with tokens, use the principle of least privilege:
 - Assign only those privileges to API tokens that are necessary to perform the actions that you want.
-- When possible, avoid using PATs because they have full control over your Axiom account.
+- When possible, use API tokens instead of PATs because PATs have full control over your Axiom account.
 
 For more information on how to use tokens in API requests, see [Get started with Axiom API](/restapi/introduction).
 
@@ -75,7 +75,7 @@ To regenerate an advanced API token, follow these steps:
 
 ## Personal access tokens (PAT)
 
-Personal access tokens (PATs) provide full control over your Axiom account. Requests authenticated with a PAT can perform every action you can perform in Axiom. When possible, avoid using PATs.
+Personal access tokens (PATs) provide full control over your Axiom account. Requests authenticated with a PAT can perform every action you can perform in Axiom. When possible, use API tokens instead of PATs.
 
 ### Create PAT
 

restapi/introduction.mdx

@@ -49,7 +49,7 @@ Encode the body of API requests as JSON objects and set the `Content-Type` heade
 To prove that API requests come from you, you must include forms of authentication called tokens in your API requests. Axiom offers two types of tokens:
 
 - [API tokens](/reference/tokens#api-tokens) let you control the actions that can be performed with the token. For example, you can specify that requests authenticated with a certain API token can only query data from a particular dataset.
-- [Personal access tokens (PATs)](/reference/tokens#personal-access-tokens-pat) provide full control over your Axiom account. Requests authenticated with a PAT can perform every action you can perform in Axiom. When possible, avoid using PATs.
+- [Personal access tokens (PATs)](/reference/tokens#personal-access-tokens-pat) provide full control over your Axiom account. Requests authenticated with a PAT can perform every action you can perform in Axiom. When possible, use API tokens instead of PATs.
 
 If you use an API token for authentication, include the API token in the `Authorization` header.