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 >
