Query-Solid icon indicating copy to clipboard operation
Query-Solid copied to clipboard

Documentation needs updating

Open james-martin-jd opened this issue 5 years ago • 3 comments

Didn't see an issue for this yet, so though I'd open one to track it. The documentation and README is currently very out of date, and doesn't cover some basic use cases. Notably missing is .set, .add, and .delete, as well as .from.

I think the rest of the docs should also be reviewed for accuracy and much has changed since it was written. Some kind of small tutorial / example code would also be very nice.

james-martin-jd avatar Dec 04 '19 20:12 james-martin-jd

So it can add files or folders now? Where can I learn how? From the test? The test is a bit abstract.

linonetwo avatar Jan 02 '20 03:01 linonetwo

@linonetwo I don't think LDFlex can specifically add empty files or folders yet, but examples of some common operations can be found here, in lieu of official documentation: https://vincenttunru.gitlab.io/tripledoc/docs/cheatsheet

Vinnl avatar Jan 02 '20 07:01 Vinnl

@linonetwo to my knowledge, no, it can't add files/folders, but it can delete. I believe .add() creates a new literal or node, and .set adds OR updates a literal or node value. But this kind of confusion is exactly why I think additional documentation is needed, as the current readme is very out of date.

I typically just use a fetch to create a file or folder, according to the Solid Spec.

james-martin-jd avatar Jan 03 '20 15:01 james-martin-jd