-
Notifications
You must be signed in to change notification settings - Fork 25
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
More docs #1104
Conversation
@@ -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`. |
There was a problem hiding this comment.
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
There was a problem hiding this comment.
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
There was a problem hiding this comment.
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)
Just a couple minor typos |
@@ -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`] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
/// 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
/// 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 |
More docs, trying to cleanup some of the main rustdoc page.