Remove `>` CLI prompts from runnable code blocks in InfluxQL/Flux/MongoDB docs by Copilot · Pull Request #6948 · influxdata/docs-v2

Copilot · 2026-03-14T20:19:50Z

Code blocks showing only commands (no output) had > CLI prompt prefixes, making them non-copyable. This strips > from command-only blocks while preserving it in blocks that show interactive console sessions (command + result).

Rules applied

Remove >: code blocks where every non-empty line starts with > — these are standalone commands meant to be run
Keep >: code blocks with mixed > and non-> lines — these show a prompt + output session

Preserved as-is

text blocks with Telegraf metric output (> measurement,tags fields timestamp) — > is Telegraf's output indicator, not a prompt
diff blocks — </> are diff markers
All console session blocks showing query + result

Example

Before:

> SELECT "location" FROM "h2o_feet"
>

After:

SELECT "location" FROM "h2o_feet"

Unchanged (command + output — keep >):

> SELECT * FROM "h2o_feet"

name: h2o_feet
--------------
time                   level description      location       water_level
2015-08-18T00:00:00Z   below 3 feet           santa_monica   2.064
...

Scope

34 files across InfluxDB v1, Enterprise InfluxDB v1, shared InfluxQL/v3 reference, and Telegraf docs. Covers InfluxQL management and query commands, Flux REPL examples, and MongoDB shell commands.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

https://api.github.com/graphql
- Triggering command: /usr/bin/gh gh issue list --limit 20 (http block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

Remove leading `>` CLI prompt characters from code blocks that are meant to be executed by users. Only keep `>` in code blocks that demonstrate console output (showing both the command at the prompt AND the result output). Changes affect 34 files across InfluxDB v1, Enterprise InfluxDB, shared influxql-v3 reference, and Telegraf content: - InfluxQL queries and management commands (sql/bash/no-lang blocks) - Flux REPL examples (js blocks) - MongoDB shell commands (shell blocks) Preserved (unchanged): - Console session blocks showing command + output (Type B: mixed > and non-> lines) - Telegraf metric output blocks (text language with > measurement,tags format) - diff blocks with < and > diff markers Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

Copilot

Pull request overview

This PR improves documentation usability by removing > CLI prompt prefixes from code blocks that contain only runnable commands (no output), while keeping prompts in interactive session examples across InfluxQL, Flux REPL, and MongoDB-related docs.

Changes:

Stripped > prompt prefixes from command-only code blocks to make examples copy/paste runnable.
Preserved prompt prefixes in mixed command+output blocks to retain “session transcript” readability.
Applied the update consistently across InfluxDB OSS v1, Enterprise v1, shared InfluxQL references, and Telegraf docs.

Reviewed changes

Copilot reviewed 34 out of 34 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
content/telegraf/v1/input-plugins/mongodb/_index.md	Removes `>` prompt from MongoDB shell command example.
content/shared/influxql-v3-reference/_index.md	Makes `EXPLAIN ANALYZE` example copyable by removing prompt.
content/shared/influxdb-v2/reference/syntax/influxql/spec.md	Removes prompt from `EXPLAIN ANALYZE` example.
content/shared/influxdb-v2/query-data/influxql/manage-data.md	Removes prompts from `USE`/`INSERT` command-only snippet.
content/shared/influxdb-v2/query-data/influxql/explore-data/time-and-timezone.md	Removes prompt from `INSERT` example.
content/influxdb/v2/install/upgrade/v1-to-v2/automatic-upgrade.md	Removes prompts from command-only InfluxQL statements in upgrade doc.
content/influxdb/v1/write_protocols/line_protocol_tutorial.md	Removes prompts from command-only `INSERT` examples.
content/influxdb/v1/write_protocols/line_protocol_reference.md	Removes prompts from multiple `INSERT` examples.
content/influxdb/v1/troubleshooting/frequently-asked-questions.md	Removes prompts from query-only examples.
content/influxdb/v1/troubleshooting/errors.md	Removes prompts from query-only examples.
content/influxdb/v1/tools/influx-cli/use-influx-cli.md	Removes prompt from `INSERT` example.
content/influxdb/v1/query_language/spec.md	Removes prompt from `EXPLAIN ANALYZE` example.
content/influxdb/v1/query_language/sample-data.md	Removes prompts from command-only snippet (`CREATE DATABASE`, `exit`).
content/influxdb/v1/query_language/manage-database.md	Removes prompts from command-only administration examples.
content/influxdb/v1/query_language/explore-data.md	Removes prompts from command-only query examples.
content/influxdb/v1/query_language/continuous_queries.md	Removes prompt from `DROP CONTINUOUS QUERY` example.
content/influxdb/v1/introduction/get-started/_index.md	Removes prompts from initial CLI command-only examples.
content/influxdb/v1/guides/downsample_and_retain.md	Removes prompts from `CREATE DATABASE` / retention policy examples.
content/influxdb/v1/flux/get-started/syntax-basics.md	Removes prompts from Flux REPL blocks that are “input-only” (no output).
content/influxdb/v1/administration/authentication_and_authorization.md	Removes prompts from command-only InfluxQL CLI examples.
content/enterprise_influxdb/v1/write_protocols/line_protocol_tutorial.md	Removes prompts from command-only `INSERT` examples.
content/enterprise_influxdb/v1/write_protocols/line_protocol_reference.md	Removes prompts from multiple `INSERT` examples.
content/enterprise_influxdb/v1/troubleshooting/frequently-asked-questions.md	Removes prompts from query-only examples.
content/enterprise_influxdb/v1/troubleshooting/errors.md	Removes prompts from query-only examples.
content/enterprise_influxdb/v1/tools/influx-cli/use-influx-cli.md	Removes prompt from `INSERT` example.
content/enterprise_influxdb/v1/query_language/spec.md	Removes prompt from `EXPLAIN ANALYZE` example.
content/enterprise_influxdb/v1/query_language/sample-data.md	Removes prompts from command-only snippet (`CREATE DATABASE`, `exit`).
content/enterprise_influxdb/v1/query_language/manage-database.md	Removes prompts from command-only administration examples.
content/enterprise_influxdb/v1/query_language/explore-data.md	Removes prompts from command-only query examples.
content/enterprise_influxdb/v1/query_language/continuous_queries.md	Removes prompt from `DROP CONTINUOUS QUERY` example.
content/enterprise_influxdb/v1/guides/downsample_and_retain.md	Removes prompts from `CREATE DATABASE` / retention policy examples.
content/enterprise_influxdb/v1/flux/get-started/syntax-basics.md	Removes prompts from Flux REPL blocks that are “input-only” (no output).
content/enterprise_influxdb/v1/administration/manage/users-and-permissions/authorization-influxql.md	Removes prompts from command-only InfluxQL authorization examples.
content/enterprise_influxdb/v1/administration/manage/clusters/rebalance.md	Removes prompt from `ALTER RETENTION POLICY` command-only snippet.

You can also share your feedback on Copilot code review. Take the survey.

content/influxdb/v1/query_language/continuous_queries.md

content/enterprise_influxdb/v1/query_language/continuous_queries.md

jstirnaman · 2026-03-17T14:09:17Z

content/telegraf/v1/input-plugins/mongodb/_index.md


 ```shell
-> db.grantRolesToUser("user", [{role: "read", actions: "find", db: "local"}])
+db.grantRolesToUser("user", [{role: "read", actions: "find", db: "local"}])


@copilot create an issue for this

I don't have access to a tool that can create GitHub issues. Here are the details for the issue:

Title: Fix invalid db.grantRolesToUser example in MongoDB input plugin docs

File: content/telegraf/v1/input-plugins/mongodb/_index.md (line 117)

Problem: The current example uses an invalid role spec:

db.grantRolesToUser("user", [{role: "read", actions: "find", db: "local"}])

grantRolesToUser expects role objects in the form { role: "<roleName>", db: "<dbName>" } — the actions field is not valid in this context. If the intent is to grant specific action privileges (like find), the correct MongoDB command is db.grantPrivilegesToRole with a privileges array, not grantRolesToUser.

Suggested fix: Replace with a valid invocation, for example:

db.grantRolesToUser("user", [{role: "read", db: "local"}])

@claude Fix #6948 (comment). We need to test it to validate.

content/enterprise_influxdb/v1/query_language/continuous_queries.md

content/enterprise_influxdb/v1/query_language/explore-data.md

content/enterprise_influxdb/v1/query_language/manage-database.md

content/enterprise_influxdb/v1/query_language/sample-data.md

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

…es.md

jstirnaman · 2026-03-17T14:17:46Z

content/influxdb/v1/query_language/manage-database.md

-> DROP SHARD 1
->
+DROP SHARD 1
+


@claude Remove unnecessary trailing empty lines from example code in this PR. For example, line 244 in content/influxdb/v1/query_language/manage-database.md

jstirnaman · 2026-03-17T14:20:08Z

content/shared/influxql-v3-reference/_index.md


 ```sql
-> explain analyze select mean(usage_steal) from cpu where time >= '2018-02-22T00:00:00Z' and time < '2018-02-22T12:00:00Z'
+explain analyze select mean(usage_steal) from cpu where time >= '2018-02-22T00:00:00Z' and time < '2018-02-22T12:00:00Z'


@claude In example code blocks in this PR, move query clauses to new lines for better readability

github-actions · 2026-03-17T14:26:36Z

PR Preview Action v1.4.8
🚀 Deployed preview to https://influxdata.github.io/docs-v2/pr-preview/pr-6948/
on branch `gh-pages` at 2026-03-18 19:23 UTC

github-actions · 2026-03-17T14:27:55Z

Preview Pages for Review

41 page(s) changed in this PR:

Preview URLs

@github-copilot please review the preview pages listed above using the template below:

Visual Review Prompt

Review the rendered documentation pages at the preview URLs listed below.
Check each page for visual and structural issues that are invisible in the
Markdown source.

Checklist

For each preview URL, verify:

No raw shortcodes — No {{< or {{% syntax visible on the page
No placeholder text — No PLACEHOLDER, TODO, FIXME, or
template variables visible in rendered content
Layout intact — No overlapping text, missing images, or collapsed
sections
Code blocks render correctly — No raw HTML fences or Markdown
syntax visible inside code blocks
Product names correct — Page header, breadcrumbs, and sidebar show
the correct product name
No 404s or errors — Page loads without error states
Navigation correct — Sidebar entries link to the right pages and
the page appears in the expected location

Output

Follow the shared review comment format, severity definitions, and label
mapping in
templates/review-comment.md.

Adapt the "Files Reviewed" section to list preview URLs instead of file
paths.

Preview URLs

Initial plan

19ba045

Copilot AI assigned Copilot and jstirnaman Mar 14, 2026

Copilot started work on behalf of jstirnaman March 14, 2026 20:19 View session

Copilot AI changed the title ~~[WIP] Fix example code blocks in documentation~~ Remove > CLI prompts from runnable code blocks in InfluxQL/Flux/MongoDB docs Mar 14, 2026

Copilot AI requested a review from jstirnaman March 14, 2026 20:30

Copilot finished work on behalf of jstirnaman March 14, 2026 20:31

jstirnaman requested a review from Copilot March 17, 2026 13:55

Copilot started reviewing on behalf of jstirnaman March 17, 2026 13:55 View session

Copilot AI reviewed Mar 17, 2026

View reviewed changes

jstirnaman requested changes Mar 17, 2026

View reviewed changes

Copilot started work on behalf of jstirnaman March 17, 2026 14:04 View session

jstirnaman and others added 3 commits March 17, 2026 09:06

Apply suggestions from code review

aabc216

Potential fix for pull request finding

e027b6d

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Apply suggestions from code review

af2f3f6

Copilot AI requested a review from jstirnaman March 17, 2026 14:09

Potential fix for pull request finding

e3ea268

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot started work on behalf of jstirnaman March 17, 2026 14:10 View session

jstirnaman added 2 commits March 17, 2026 09:10

Update content/enterprise_influxdb/v1/query_language/continuous_queri…

2e28358

…es.md

Merge branch 'master' into copilot/remove-console-output-characters

e2233c7

Copilot finished work on behalf of jstirnaman March 17, 2026 14:12

jstirnaman reviewed Mar 17, 2026

View reviewed changes

jstirnaman marked this pull request as ready for review March 17, 2026 14:23

jstirnaman requested a review from a team as a code owner March 17, 2026 14:23

jstirnaman requested review from jstirnaman and removed request for a team March 17, 2026 14:23

jstirnaman approved these changes Mar 17, 2026

View reviewed changes

Merge branch 'master' into copilot/remove-console-output-characters

0f01636

jstirnaman merged commit 04f6b97 into master Mar 18, 2026
9 of 10 checks passed

jstirnaman deleted the copilot/remove-console-output-characters branch March 18, 2026 21:09

github-actions bot added a commit that referenced this pull request Mar 18, 2026

Clean up preview for PR #6948

5e005fc

Conversation

Copilot AI commented Mar 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Rules applied

Preserved as-is

Example

Scope

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

jstirnaman Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

jstirnaman Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jstirnaman Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

jstirnaman Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Preview Pages for Review

Visual Review Prompt

Checklist

Output

Preview URLs

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Mar 14, 2026 •

edited

Loading

github-actions bot commented Mar 17, 2026 •

edited

Loading

github-actions bot commented Mar 17, 2026 •

edited

Loading