vortex Intro guide for Vortex

When doing https://github.com/vortex-data/vortex/pull/3906 I couldn't find a way in the documentation to put information about this method - even though debug printing feels like a very important tool for learning a new library

Moreover, as I was getting into the project, I couldn't find a simple cheat sheet on Vortex containing basic ops like:

how to create a new array (for different types, for example that you want to use VarBin for string)
how to print them
how to iterate them
how to get individual element
how to modify an array
how to write it to the file
and so on
what's the difference from, e.g. VarBinArray from VarBinView

To be fair, some of those are covered in examples, but it's very slow to iterate over all of them checking if they have something you need.

I think we should have this information as a single page in two ways:

pretty formatted and concise for humans, with some comments and explanation
in vortex.dev/llm.txt for LLMs. Example: https://alloy.rs/llms-full.txt and https://alloy.rs/introduction/prompting

Jul 23 '25 20:07 blaginin

Doing this feels like a good way to learn the project, so adding gfi

Jul 23 '25 20:07 blaginin

hey! I would like to pick this up if that's okay?

Oct 01 '25 02:10 ptravers

sure

Oct 01 '25 04:10 blaginin

@ptravers That would be fantastic! Let us know if we can help along the way.

Oct 01 '25 08:10 0ax1

great! thanks will start on this today!

Oct 08 '25 17:10 ptravers

hey @ptravers! Just wanted to check if you need any help with the issue 🙂

Oct 22 '25 12:10 blaginin

just reviewing my work before I ping you. I created a cookbook doc and some example rust code in an examples directory. does that make sense to you both?

Oct 23 '25 00:10 ptravers

put up a draft PR. still self reviewing will add you both when ready for final review.

Oct 23 '25 22:10 ptravers