Skip to content
This repository has been archived by the owner on Dec 21, 2023. It is now read-only.

Add the Maui.Graphics website to the repository details #463

Closed
bmitc opened this issue Jun 30, 2022 · 6 comments
Closed

Add the Maui.Graphics website to the repository details #463

bmitc opened this issue Jun 30, 2022 · 6 comments

Comments

@bmitc
Copy link

bmitc commented Jun 30, 2022

I wasn't finding information in the README how to actually use the library, but I found the Maui.Graphics website, which also links to the official documentation.

I think the Maui.Graphics website should be put in the repository details, and that the documentation should be linked to from the README.

@swharden
Copy link
Contributor

Hi @bmitc and project owners (@jonlipsky)

I registered https://maui.graphics a while ago because I kept trying to search for documentation about this library but .graphics is a top level domain so my browser would try to go to that URL and timeout. To be clear, I'm an open source maintainer who enjoys making .NET apps, and I'm not affiliated with Microsoft.

At one time I considered putting quickstarts and code examples on the site, but I don't think I'm the best person to create/maintain/represent idiomatic use cases for this library at this time, so I am currently just linking to the best official documentation page I'm aware of.

If this group has a better recommendation for what should be at that URL, I welcome the input!

PS: I noticed when people tweet the phrase "maui.graphics" it automatically hyperlinks to that page (e.g., https://twitter.com/jonlipsky/status/1529185387846873088)

PPS: I heard @jamesmontemagno mention the domain on Merge Conflict episode #302, so I welcome input from him too

@bmitc
Copy link
Author

bmitc commented Jun 30, 2022

Thanks for the heads up on that @swharden. It looked so nice, that I just assumed it was official. 🙂 So yea, up to the project maintainers on that aspect.

After actually reading the official documentation, it's only from the perspective of using Maui.Graphics from Maui itself, but I think that at a minimum it should be included somewhere in the README.

@swharden
Copy link
Contributor

Thanks for the heads up on that @swharden. It looked so nice, that I just assumed it was official.

haha, thanks! 🚀

After actually reading the official documentation, it's only from the perspective of using Maui.Graphics from Maui itself

I'm not aware of any official documentation about how to use Maui.Graphics in non-Maui apps. The topic seems highly relevant since .NET 6 deprecated cross-platform support for System.Drawing.Common and one of Microsoft's recommended actions is to use this library instead.

I put some Maui.Graphics Quickstart pages on C# Data Visualization showing how I use this library in Console, WinForms, and WPF apps that you may find useful.

@jonlipsky
Copy link
Contributor

@swharden I thought it was official as well! I absolutely love that page.

@bmitc FYI... The dirty secret about Maui graphics is that despite the name, Maui.Graphics has no dependencies on Maui. I use it in several production apps, and none of them are Maui apps. I use it with Xamarin.Mac, Xamarin.iOS, Xamarin.Android and WPF, and one Xamarin.Forms app currently only deployed to iOS.

@bmitc
Copy link
Author

bmitc commented Jun 30, 2022

@jonlipsky Thanks for the information! I was at least hoping that is the case. So as to not distract from this documentation related issue, I've posted a question regarding that in the discussions section: #466

I've been meaning to ask that question anyway. Although I'm concerned that there's too much fragmentation for .NET graphics libraries and GUI frameworks, as mentioned here #272, I'm still trying to do due diligence in considering all alternatives for existing .NET graphics solutions.

@bmitc
Copy link
Author

bmitc commented Jan 9, 2023

Repository is no longer under development. See #496 (comment).

@bmitc bmitc closed this as completed Jan 9, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants