Complete Syntax Document for Dataview

[dbgnvan2]

I'm pretty new to dataview and I'm have a heck of a type getting decent documentation. It seems too simplistic or expects someone to know everything. By way of example, using a very helpful example:

list without id
L.text
from "path/to/folder"
flatten file.lists as L
where contains(L.tags, "#foo")

1. Is "path/to/folder" for pulling from the parent FOLDER? Is there meta data for this e.g. "file.folder"?
2. where did file.lists come from - meta data listing with explanation?
3. I can't figure out "flatten" from the documentation. it's too abbreviated.
4. "as L" is this just shorthand or does this create a new object with data in it?
5. contains(L.tags, "#foo") I know contains. But the implication is that there is an array? of items and thus include only the items ( points, tasks ) with the tag #foo on that line? ( Or block, or child points )?
6. is L.tags equal to file.lists.tags?

I'm not a java programmer but get SQL, I have programmed, do excel formulas, etc. I get the idea of file.name - but where is this documented? (there is a meta data document - it's pretty complete, but no discussion of why you might want to use this or examples.)

Better documentation would help non-programs get a lot more out of Obsidian (which I am loving!)

Thanks - maybe I just need to create something.

[dbgnvan2]

PS reference to Metadata https://github.com/blacksmithgu/obsidian-dataview/tree/master/docs/docs/annotation

[mnvwvnm]

Why not start by plugin documentation?
All your questions are related with basic doubts:

• how to use FROM command;
• what the metadata structure inside each note;
• the types of each data (strings, links, arrays/lists, etc.)
• etc.

If you want to see the structure of metadata in a specific file, run this inline js query (you need to enable js inline queries in settings > dataview):

`$=dv.span(dv.current())`