Re: [Rust] Blog post for 2.0.0

2020-10-27 Thread Andy Grove
The Rust blog post is now live: https://arrow.apache.org/blog/2020/10/27/rust-2.0.0-release/ On Sun, Oct 18, 2020 at 12:46 PM Fernando Herrera < fernando.j.herr...@gmail.com> wrote: > Thanks Jorge for helping me to get across the need for a user guide. The > examples you used are exactly what I h

Re: [Rust] Blog post for 2.0.0

2020-10-18 Thread Fernando Herrera
Thanks Jorge for helping me to get across the need for a user guide. The examples you used are exactly what I had in mind. It would be great if the project had a user guide similar to tokio's. We could use this guide to explain how to get started and some examples using the available crates (Arrow,

Re: [Rust] Blog post for 2.0.0

2020-10-16 Thread Jorge Cardoso Leitão
Hi, I would like to thank Fernando for raising this concern here: I also think that we still do not put enough effort in the documentation :) I admit that when I started in the project, I also had that need and just had some time to go through the code. First, I find it useful to distinguish type

Re: [Rust] Blog post for 2.0.0

2020-10-16 Thread Fernando Herrera
I understand the concern, especially with the project changing that quickly. However, I haven't found a good material that I can use to learn how to use the crate. I know that each module has a lot of tests (which I'm thankful for) but going from one test case to the other doesn't work well as lear

Re: [Rust] Blog post for 2.0.0

2020-10-16 Thread Micah Kornfield
> > We should be careful with the balance of content between the Restructured > Text Format documentation and the documentation in the crate that gets > published to docs.rs though. The rustdoc documentation is unit-tested to > ensure that it is always up to date and we will have to manually update

Re: [Rust] Blog post for 2.0.0

2020-10-16 Thread Andy Grove
I think that it would be great to produce this kind of content. I'm giving a presentation on Arrow to my local Rust meetup (virtually) next week and these are similar to the topics I will be covering there. We should be careful with the balance of content between the Restructured Text Format docum

Re: [Rust] Blog post for 2.0.0

2020-10-16 Thread Micah Kornfield
Java and C++ have tutorials in Restructured Text Format in the docs folder [1]. I think creating something similar for Rust might be the best place to start. These are rendered on the website. For example Java is located at [2]. [1] https://github.com/apache/arrow/tree/master/docs/source [2] h

Re: [Rust] Blog post for 2.0.0

2020-10-16 Thread Fernando Herrera
I was working on the blog post I mentioned before regarding Arrow usage (rust) and how to use the different elements available in the create. After some thought, these were the topics I want to include: 1. Arrays examples and how they look like Basic arrays and nested arrays The buffer st

Re: [Rust] Blog post for 2.0.0

2020-10-15 Thread Mark Farnan
I would agree with this. I’ve been working with the GO Arrow library last few weeks, and took a while to get head around it all / how to use etc. Even then not sure i’ve got it right. Usage examples would be great. Regards Mark > On Oct 14, 2020, at 4:08 PM, Fernando Herrera > wrote: > >

Re: [Rust] Blog post for 2.0.0

2020-10-14 Thread Fernando Herrera
I was wondering if besides this blog post there should be another on with an example of usage. I think that is one of the key things missing for Arrow in general. This example should show the problems that Arrow is solving and how to implement the solution in real life. On Tue, Oct 13, 2020 at 10:

[Rust] Blog post for 2.0.0

2020-10-13 Thread Andy Grove
There has been a huge amount of activity in the Rust subproject for the 2.0.0 release and I think that we should write a Rust-specific blog post to go on the Arrow blog. I made a brief start at a Google doc, which is mostly just bullet points listing some things we could talk about. I'm sure I've