Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

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

Aberta
  • Algo errado?
#3,903 5 comentários 1 reação 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
35/100
Tipo de issue
Documentação
Clareza
Razoavelmente clara
Status de atividade
Estagnada
Stack de tecnologia
csharp
Domínio
documentation

Direção de pesquisa

Comece revisando o site atual em materialdesigninxaml.net junto com o repositório, a Wiki, as notas de versão e os pacotes NuGet atuais. Atualize o guia Getting Started, adicione cobertura e demonstrações ao vivo para controles e recursos mais recentes e atualize os detalhes dos pacotes, os snippets de código e os exemplos. O trabalho estará concluído quando o site refletir os recursos atuais da biblioteca e as orientações de configuração.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

enhancement evaluation required

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.

Linguagem predominante
C#
Estrelas
16.3k
Forks
3.5k
Merge médio
1d 22h
PRs com merge (30d)
10

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de MaterialDesignInXAML/MaterialDesignInXamlToolkit

Todas as issues de MaterialDesignInXAML/MaterialDesignInXamlToolkit

Issues semelhantes

Mais issues de C#

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.