CommunityToolkit / CommunityToolkit/Maui.NativeLibraryInterop

Great idea with examples but poorly documented

Open
#85 2 comments 3 reactions 0 assignees View on GitHub
documentation
Dominant language
C#
Stars
249
Forks
48
PR merge metrics
No merged PRs in 30d

Description

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!

Contributor guide

No contributing guide indexed for this repository

Research direction

Review the repository's existing documentation and examples, focusing first on how to include "newBinding" and the stated Mac dependency. Compare the Android Studio and Xcode knowledge assumed by the examples. Done means the setup, dependencies, and example usage are explained clearly enough for developers with less native-platform experience.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, csharp, ios, macos
Domain
documentation, mobile-dev
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.