Skip to content

Commit ad78e9b

Browse files
docs: allow Arrow-native in N2 and close the native rules
T7 lists Arrow-native, which N3's limit to N2 compounds outside the contributor guide would otherwise forbid. N3 also says any other use of native is a finding, so a phrase outside the lists has an outcome. Generated-by: OpenCode
1 parent 3b2fb4a commit ad78e9b

1 file changed

Lines changed: 4 additions & 3 deletions

File tree

‎docs/source/contributor-guide/style_guide.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -92,14 +92,15 @@ is meant. Name the meaning instead.
9292
which need not appear beside it); "native", optionally followed by a format, followed by _scan_,
9393
_reader_, _write_, or _writer_, for Comet's Rust scans and writers (_native scan_, _native Parquet
9494
reader_, _native Iceberg write_); _native memory_ and _native library_ (the terms Comet's own log
95-
lines use); _Native_ as the expression kind (T6); and _native implementation_ of an expression,
96-
meaning its Rust implementation.
95+
lines use); _Arrow-native_ (T7); _Native_ as the expression kind (T6); and _native implementation_
96+
of an expression, meaning its Rust implementation.
9797
- **N3.** In the contributor guide, "native" before a code noun is also allowed when it means the
9898
crates under `native/` or the JNI boundary: _native code_, _native side_ (and _native-side logs_),
9999
_native plan_, _native kernel_, and _JVM/native boundary_. The noun must name something under
100100
`native/`, such as a crate, file, type, function, or plan, or the JNI boundary. Pages outside the
101101
contributor guide, including `user-guide/`, `about/`, `index.md`, `README.md`, and `.doc(...)`
102-
strings, allow only the N2 compounds and write _Rust_ instead. N1 applies everywhere.
102+
strings, allow only the N2 compounds and write _Rust_ instead. N1 applies everywhere. Any other use
103+
of "native" is a finding: name the meaning with a term from the vocabulary above.
103104
- **N4.** Do not use "native" as a noun. Write _the Rust side_ or name the component: "hands each
104105
block to the Rust side", not "hands each block to native".
105106
- **N5.** Do not call Spark's own behavior native. Write _Spark's built-in shuffle_, not _Spark's

0 commit comments

Comments
 (0)