Great idea with examples but poorly documented

[PaolaBiondi]

First of all I would like to express my appreciation for starting this journey with native lib. I'm looking forward seeing MAUI as fully-fledged platform and not creating obstacles for developers starting the journey with mobile apps.
However, I find current repo and accompanying documentation being poorly explained. Those who understand documentation are those who do not require it, it is written more in the manner of "notes to my future self", making it difficult for those who truly need guidance.
For instance, there is no mentioning of how to actually include "newBinding". Mac dependency is not emphasized for project to work out of the box.
I would be much happier to see a situation where less knowledge of android/ios, i.e. android studio/xcode knowledge is required to understand the provided examples.
Good luck!

[rachelkang]

Hi, @PaolaBiondi - thank you for your feedback.

Regarding "how to actually include newBinding" - the docs here mention how to include a new binding in a MAUI app via the appropriate project references: https://learn.microsoft.com/dotnet/communitytoolkit/maui/native-library-interop/get-started#consume-the-apis-in-your-net-app

If you have further feedback, please share more details about what specific documentation you seek, as we work to continuously improve our documentation.

[PaolaBiondi]

@rachelkang thank you for reaching back. I do think that one day what you and the rest of the team are doing will surely contribute to a better future for all of us.
I have started with MAUI privately, starting from low low level of mobile programming. Claims like it is "one code for all platforms" have attracted me to it, but to my disappointment it is not at all good starting point. I thought that with it i will not need to study deeply android/ios, but it is not the case. I've got impression you are working on iOS, as most of the examples are targeting only that platform, perhaps most of MAUI consumers also have mac. I do not. I have windows and working in VS+MAUI is draining my laptop battery so fast, work reduced from 4hours to 1 hour. It becomes frustrating when suddenly in your examples I get red herrings (e.g. precompiler condition does not recognize imported package name) even though nothing is changed, build and start lasts for ages. Simple saying, it is challenging🤯
Documentation mentions template project but what would have been of use in this manual to have explicit button pointing to git repo somewhere at the beginning.
It would be of use to have explanation of specific attributes in project script. I know you assume we are smart enough to search for the explanation on internet but this is time consuming and we could be easily lost in the plethora of the content found on internet or AI giving wrong answers.
It would be great to have videos or workshop with simple steps.