lake: descriptions that need product confirmation in TiDB Cloud Lake docs
Maintainer antworten meist innerhalb von 1 Tag
@awxxxxxx arbeitet bereits daran.
Seit 14.10.2026.
Bewertung
Dieses Issue wurde noch nicht bewertet.
Beschreibung
While reviewing the Japanese translation of the TiDB Cloud Lake docs, I found the following descriptions in the English docs (release-8.5, tidb-cloud-lake/) that look inconsistent. Fixing them needs knowledge of the actual product behavior, so I list them here instead of changing them. The clear typos and contradictions are fixed in #24452 and #24453.
| # | File | Issue |
|---|---|---|
| 1 | sql/h3-edge-angle.md | The summary and body say "Returns the average length of the H3 hexagon edge in grades", but geospatial-functions.md describes H3_EDGE_ANGLE as "Return the angle in radians between two edges". |
| 2 | sql/var-pop.md, var-samp.md, variance-pop.md, variance-samp.md | Each says "Alias for COVAR_POP" or "Alias for COVAR_SAMP" (two-argument covariance), while aggregate-functions.md describes VAR_POP and VARIANCE_POP as "Population variance" with VAR_POP(height). |
| 3 | sql/unset.md | The third example (around line 105) says UNSET SESSION reverts the setting "back to the session-level setting". The other examples and the level table say it reverts to the global-level or default setting. |
| 4 | sql/geospatial-functions.md | Geometry constructors such as ST_MAKEGEOMPOINT and ST_POLYGON are marked "GEOGRAPHY only", although they construct GEOMETRY values. |
| 5 | sql/sql-identifiers.md | Line 107 says the example highlights the "case-sensitivity by default", but the page explains that unquoted identifiers are case-insensitive by default. |
| 6 | sql/numeric-functions.md | The NEG / NEGATE example is -5 → -5, which does not show negation (for example, NEG(5) → -5). |
| 7 | sql/create-stage.md | "Example 3: Create External Stage with AWS IAM User" creates an IAM user and access keys in steps 1-2, but step 3 says "Use the IAM role" and the code uses ROLE_ARN and EXTERNAL_ID. |
| 8 | sql/st-geogetryfromwkb.md | The page title and function name are ST_GEOGETRYFROMWKB. Is this the real function name, or a typo for ST_GEOGRAPHYFROMWKB? |
| 9 | guides/privileges.md | In UDF Privileges, USAGE says "For example, copy into a stage, presign upload" and ALL says "Grants READ, WRITE privileges", which look copied from Stage Privileges. |
| 10 | sql/system-settings.md | The description of enable_hive_parquet_predict_pushdown says "predict pushdown" (probably "predicate pushdown"; the setting name is unchanged). Several rows also say "maximum memory ratio in bytes". |
| 11 | guides/benchmark-data-ingestion.md | The "Use the COPY INTO command" step links its SQL Script to .../snowflake/setup.sql. Is a separate copy script intended? |
| 12 | guides/load-from-local-file.md | The Tutorial 2 command INSERT INTO book_db.bookcomments(title,author,date) file_format=(type=csv) has no from @_databend_load, unlike Tutorial 1. |
| 13 | guides/load-orc.md, load-tsv.md | load-orc numbers its steps 1, 2, 4, 5 (no step 3). load-tsv has two "Step 4" headings ("Step 4 (Option)"), while load-parquet uses "Step 5 (Optional)". |
| 14 | guides/audit-trail.md | It says "five system history tables", but the table lists three. |
| 15 | guides/authenticate-with-aws-iam-role.md | Line 31 says to select Custom trust policy under Create policy. That option belongs to the Create role flow (line 57). |
| 16 | guides/support-services.md | "4/7 coverage and response window for Severity 1 issues". "24/7" is likely intended, but the upstream Databend Cloud page also says "4/7". Which is correct? (Moved here from #24453.) |
| 17 | sql/create-function.md, sql/alter-function-sql.md | The parameter tables list <input_param_names> and <lambda_expression>, but the syntax shown is only AS ( <input_param_types> ) RETURNS <return_type> .... Are these rows stale? (Reported by CodeRabbit on #24452.) |
The Japanese docs follow the English for all of these, so fixing the English is enough; the Japanese will follow through the regular sync.
- Vorherrschende Sprache
- Python
- Sterne
- 616
- Forks
- 724
- Ø Merge
- 2 T. 5 Std.
- Gemergte PRs (30 T.)
- 168
Entwicklungsumgebung
- Kein Dockerfile und keine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus pingcap/docs
-
Weekly keywords check: mismatches foundEvtl. vergeben @saryn17 hat das vor 57 Tagen übernommen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
Maintainer antworten meist innerhalb von 1 Tag
-
Broken Link DetectedOffen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 66/100
Maintainer antworten meist innerhalb von 1 Tag
-
Weekly keywords check: mismatches foundEvtl. vergeben @saryn17 hat das vor 57 Tagen übernommen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 66/100
Maintainer antworten meist innerhalb von 1 Tag
-
Broken Link DetectedOffen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 66/100
Maintainer antworten meist innerhalb von 1 Tag
-
tidb-cloud: Terraform import procedures need Terraform v1.5.0 or later, but the prerequisite says >=1.0Evtl. vergeben @yahonda hat das vor 5 Tagen übernommen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 77/100
Maintainer antworten meist innerhalb von 1 Tag
Ähnliche Issues
-
area:security effort:S priority:P3 status:needs-triage type:chore
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
randomparity/kdive#3657 ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
aws/mcp-proxy-for-aws#476 ·
Maintainer antworten meist innerhalb von 1 Tag
-
fix(cli): a --root that does not exist exits 0 with 'Scanned 0 file(s)', so a wrong path in CI passes silentlyEvtl. vergeben @arpanjot-coding hat das heute übernommen. Offenarea: runtime automation bug cli code-scanning consistency developer-experience difficulty: easy github-actions good first issue help wanted json-output priority: P3 python sarif silent-failure static-analysis tests
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
-
ContainsOnly raises TypeError for unhashable input with set-based choicesEvtl. vergeben @prathamchoksi hat das heute übernommen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 84/100
marshmallow-code/marshmallow#3115 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
Maintainer antworten meist innerhalb von 1 Tag