Thanks Jorge. It does mean a lot your comments, and please, do help me get it better.
I was wondering as well to put it inside the arrow crate but at the beginning I think it is going to be changing a lot, so I think it would be a good idea to keep it in a separate repo so we can iterate on it as much as possible. What about creating a Rust Arrow group in github to keep the fast changing projects apart in different repos but with in the same group? Fernando, On Mon, 1 Feb 2021, 17:28 Jorge Cardoso Leitão, <jorgecarlei...@gmail.com> wrote: > I went through it, and I have to say that it is really well written and > contains non-trivial knowledge about the arrow crate. Thank you very much > for this, Fernando. > > In my opinion alone, the guide or a variation of it could be incorporated > into the arrow repo and released together with the crate, as is standard in > other rust projects. I for one would contribute and put time into enhancing > and maintaining it as part of the rust implementation, review changes to it > by other contributors, and keep it up to date. > > Best, > Jorge > > > > > On Sun, Jan 31, 2021 at 6:25 PM Fernando Herrera < > fernando.j.herr...@gmail.com> wrote: > > > Hi all, > > > > During the past months I have been trying to read and understand the code > > base for the Rust implementation of Arrow. At the beginning I was just > > reading the code and figuring out what each part or module was used for. > > Unfortunately this approach didn't work very well and had to start from > > scratch. The next time while trying to understand it I was also writing > > descriptions of the things I was studying and how to implement them. This > > approach led me to writing up a small Arrow guide. > > > > At this point is not complete and has several chapters missing, but > that's > > the point of this mail. I was wondering if someone that wants to work (or > > is already working) on the Rust side would like to help me make the guide > > better and richer. > > > > The first sections can be found here: > > https://elferherrera.github.io/arrow_guide/introduction.html > > > > And the repo is here: > > https://github.com/elferherrera/arrow_guide/ > > > > The guide at the moment is written with mdbook and uses the doc-comment > > crate to check all the code. Also, the book is pulling the Arrow crate > from > > git directly, so it is always reading the most recent api. > > > > I hope someone finds these writings useful and if you are willing to help > > me just let me know. > > > > Thanks, > > Fernando > > >
