diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java
index ef638aa1bed7..41465bfe11ac 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java
@@ -72,8 +72,8 @@ public BigQueryError(String reason, String location, String message) {
/**
* Returns short error code that summarizes the error.
*
- * @see Troubleshooting
- * Errors
+ * @see BigQuery API HTTP status and
+ * error codes
*/
public String getReason() {
return reason;
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java
index c42ff6327527..212b4c4d3e6a 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java
@@ -30,12 +30,14 @@
/**
* BigQuery service exception.
*
- * @see Google Cloud BigQuery
+ * @see BigQuery API HTTP status and
* error codes
+ * @see BigQuery client and
+ * connectivity error messages
*/
public final class BigQueryException extends BaseHttpServiceException {
- // see: https://cloud.google.com/bigquery/troubleshooting-errors
+ // see: https://docs.cloud.google.com/bigquery/docs/errors
private static final Set RETRYABLE_ERRORS =
ImmutableSet.of(
new Error(500, null), new Error(502, null), new Error(503, null), new Error(504, null));
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java
index 672c6ad3faee..aa0191e917f9 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java
@@ -22,7 +22,7 @@
/**
* BigQuery service exception.
*
- * @see Google Cloud BigQuery
+ * @see BigQuery API HTTP status and
* error codes
*/
public final class BigQuerySQLException extends SQLException {
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java
index 3ac24293c653..ecd48c375350 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java
@@ -114,8 +114,8 @@ public State getState() {
* Returns the final error result of the job. If present, indicates that the job has completed and
* was unsuccessful.
*
- * @see Troubleshooting
- * Errors
+ * @see BigQuery API HTTP status and
+ * error codes
*/
@Nullable
public BigQueryError getError() {
@@ -126,8 +126,8 @@ public BigQueryError getError() {
* Returns all errors encountered during the running of the job. Errors here do not necessarily
* mean that the job has completed or was unsuccessful.
*
- * @see Troubleshooting
- * Errors
+ * @see BigQuery API HTTP status and
+ * error codes
*/
public List getExecutionErrors() {
return executionErrors;
diff --git a/java-bigquery/samples/snippets/src/main/java/com/example/bigquery/SimpleApp.java b/java-bigquery/samples/snippets/src/main/java/com/example/bigquery/SimpleApp.java
index 7b72bb0f9409..e75837cad3da 100644
--- a/java-bigquery/samples/snippets/src/main/java/com/example/bigquery/SimpleApp.java
+++ b/java-bigquery/samples/snippets/src/main/java/com/example/bigquery/SimpleApp.java
@@ -71,7 +71,7 @@ public static void simpleApp(String projectId) {
&& queryJob.getStatus().getExecutionErrors().size() > 0) {
// TODO(developer): Handle errors here. An error here do not necessarily mean that the job
// has completed or was unsuccessful.
- // For more details: https://cloud.google.com/bigquery/troubleshooting-errors
+ // For more details: https://docs.cloud.google.com/bigquery/docs/errors
throw new RuntimeException("An unhandled error has occurred");
}
// [END bigquery_simple_app_query]