MaterialDesignInXAML / MaterialDesignInXAML/MaterialDesignInXamlToolkit

Proposal: Update and refresh the documentation website (materialdesigninxaml.net)

Aperta
#3,903 5 commenti 1 reazione 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

enhancement evaluation required
Lingua principale
C#
Stelle
16.3k
Fork
3.5k
Merge medio
1g 22h
PR unite (30g)
8

Descrizione

Is your feature request related to a problem? Please describe.
Yes, the current documentation website, https://materialdesigninxaml.net/, appears to be significantly outdated. As a developer using the library, this creates several challenges:

  • It doesn't showcase many of the new controls, features, and packages that have been added in recent versions.
  • This can lead to confusion, as users might not be aware of the full capabilities of the toolkit and may spend time trying to create solutions that already exist.
  • New users may have a difficult time getting started, as the information they find on the official site doesn't align with the latest NuGet packages and best practices.
  • It can give the incorrect impression that the project is not actively maintained, which is far from the truth given the great work done in the repository.

Describe the solution you'd like
I propose a comprehensive update to the website to bring it in line with the current state of the library. This would ideally include:

  • Updating the "Getting Started" guide to reflect the latest installation and setup procedures.
  • Adding documentation and live demos for newer controls and features that are currently missing.
  • Updating information about the available NuGet packages (like the color tool, transitions, etc.) and their specific functionalities.
  • Ensuring all code snippets and examples are up-to-date with the latest API and best practices.

Describe alternatives you've considered
The main alternative is for users to rely solely on the GitHub repository, the Wiki, and release notes to understand new features. While this is possible for experienced users, it presents a high barrier to entry for newcomers and is less efficient than having a centralized, user-friendly documentation site that serves as the project's "front door".

Additional context
First of all, thank you for this fantastic library! It's an invaluable tool for WPF developers. An updated website would greatly improve the user experience, help with adoption, and better showcase the incredible progress the project has made. I believe this would be a significant enhancement for the entire community.

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia esaminando il sito attuale all'indirizzo materialdesigninxaml.net insieme al repository, al Wiki, alle note di rilascio e ai pacchetti NuGet correnti. Aggiorna la guida Getting Started, aggiungi la copertura e demo live per i controlli e le funzionalità più recenti e aggiorna i dettagli dei pacchetti, gli snippet di codice e gli esempi. Il lavoro è completato quando il sito riflette le funzionalità attuali della libreria e le indicazioni per la configurazione.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
csharp
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.