Storage not documented

[ygoe]

On which page?

https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Storage/StorageOverview.html

What's wrong?

It speaks of a walkthrough but I see nothing. No tutorial, no API reference, no Google results. Does it even exist?

Any feedback?

Documentation is really an issue with Uno. I understand that it relies on WinUI3 and likes to refer to that documentation, but it deviates often enough that it's often unclear how things work. The Uno dev team knows it because they've written it but nobody else does. And this feature is even explicitly Uno-specific, so it absolutely needs an explanation.

I guess I'll start with normal File access and see how far I get on Android. Never worked with files in own apps there. All I know is that Android has a different opinion of using files than desktop OSs have.

[DevTKSS]

Would also appreciate that to be documented! Would like to add: not only files access on Android / IOS, because their specification with the Entitlements is at least a bit documentated, but lets say we would like to "just" do CRUD operations on a Windows or Desktop target, I did not find any documentation for how to do that with uno at all... just like to consume data from there or save things the app is used for... Maybe its so basically no one of the team did think needed to be documentated or at least linked properly to the pages where we would find more information? Only Data I could consume with apps from the docs would be api web data or the configuration things, which not even containing things like where would we store things like secrets? in configuration? Dont think so! In other frameworks it is done with a dotenv-vault, but running in vs code is not for every app good...

[kazo0]

Thanks for the report @ygoe!

It indeed would be great to add more info to the Storage documentation

Along with this, it would be also beneficial to have a sample app created and pushed to the Uno.Samples repo that demonstrates usages

This has been added to the backlog, but, in the meantime, if anyone would like to contribute their time to further explain and make a PR for this, that would be very greatly appreciated!

If it helps, I have tried to add some more explanation on using Storage Extensions in this discussion.

[DevTKSS]

@kazo0

I did research that storage topic last week and got to some point on thinking where I would like maybe your opinion to this if you dont mind:

In the storage app sample the data has been in json but in apps like the WindowsAppSDK gallery as simple example, they did something similar to add the sample code into their app...

Okay so my question that I neverending thought about, are we overall able to use storage without using serialization?
Like every file we would like to use which is not photo/video content, would need that, isnt it?
And beside the json serializer i did see in the documentation which I thought to be already included in http uno feature or authentication there was not really anything to find for this.

I am a bit struggling to seperate this features in my understanding. I did see that many other things auth is adding, thats clear, but seems like all of them using that attribute for the serializer. Are we overall able to use data in non json format and imagelike content? XML serializer along my research is outdated🤔