Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

More docs #1104

Merged
merged 3 commits into from
Oct 21, 2024
Merged

More docs #1104

merged 3 commits into from
Oct 21, 2024

Conversation

AdamGS
Copy link
Contributor

@AdamGS AdamGS commented Oct 21, 2024

More docs, trying to cleanup some of the main rustdoc page.

@@ -21,6 +21,10 @@ pub trait ArrayDef {
type Encoding: ArrayEncoding + ArrayEncodingExt<D = Self>;
}

/// Macro to generate all the necessary code for a new type of array encoding. Including:
/// 1. New Array type that implements `AsRef<Array>`, `GetArrayMetadata`, `ToArray`, `IntoArray`, and multiple useful `From`/`TryFrom` implementations.
/// 1. New Encoding type that implements `ArrayEncoding`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Numbering is 1, 1, 1

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Markdown auto-generates the right numbers

Copy link
Contributor Author

@AdamGS AdamGS Oct 21, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+ makes it easier to re-order/add more points (checked both VSCode and rustdoc renders it correctly)

vortex-array/src/arrow/dtype.rs Outdated Show resolved Hide resolved
vortex-array/src/lib.rs Outdated Show resolved Hide resolved
@lwwmanning
Copy link
Member

Just a couple minor typos

@AdamGS AdamGS enabled auto-merge (squash) October 21, 2024 12:39
@AdamGS AdamGS merged commit 008b3a7 into develop Oct 21, 2024
5 checks passed
@AdamGS AdamGS deleted the adamg/docs-20241021 branch October 21, 2024 12:41
@@ -131,6 +131,7 @@ pub fn infer_schema(dtype: &DType) -> VortexResult<Schema> {
Ok(builder.finish())
}

/// Try to convert a Vortex [`DType`] into an a Arrow [`DataType`]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// Try to convert a Vortex [`DType`] into an a Arrow [`DataType`]
/// Try to convert a Vortex [`DType`] into an Arrow [`DataType`]

@@ -62,9 +61,14 @@ pub mod flatbuffers {
pub use vortex_flatbuffers::array::*;
}

/// A central type for all Vortex arrays, which are known length sequences of compressed data.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// A central type for all Vortex arrays, which are known length sequences of compressed data.
/// A central type for all Vortex arrays, which are known length sequences of typed and possibly compressed data

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants