CommunityToolkit / CommunityToolkit/Tooling-Windows-Submodule

Implement Markdown Rendering Support for Notes, Warnings, and Info in Sample App

Abierto
#70 1 comentario 0 reacciones 0 asignados Ver en GitHub
dev loop ➰ documentation :page_with_curl: sample app 🖼
Lenguaje dominante
C#
Estrellas
55
Forks
19
Merge medio
40 min
PR fusionados (30 d)
1

Descripción

## Background
The sample applications for both CommunityToolkit vNext and CommunityToolkit Labs currently utilize an "Experimental" InfoBar with "Informational" severity.

## Problem
The aforementioned notice is exclusively applicable to Labs components and is not removable in the Toolkit vNext sample app.

## Solution
- [ ] Remove the notice from the sample app.
- [ ] Integrate the notice as a feature of the markdown renderer within the sample app. This will allow for better rendering of documents that contain elements like `![NOTE] Some information`, which currently do not render as expected.
- [ ] Update existing markdown in Labs and Toolkit vNext to include the experimental InfoBar. We'll remove them from vNext when we launch stable.

This change will enhance the readability of our documentation and ensure consistent user experience across both CommunityToolkit vNext and CommunityToolkit Labs.

## Open questions
Both DocFX and GitHub have their own syntax for this.
- GitHub: https://github.com/orgs/community/discussions/16925
- DocFX: https://dotnet.github.io/docfx/docs/markdown.html?tabs=linux%2Cdotnet#alerts

Which one do we want to use?
- If we use **GitHub** syntax, it will display on GitHub correctly, but need to be transformed to the DocFX format when we add support for that.
- If we use **DocFX** syntax, it won't need to be transformed before being built for DocFX, but it also won't show up right on GitHub.

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

Comienza con el renderizador Markdown de las aplicaciones de ejemplo e inspecciona la Experimental InfoBar existente en CommunityToolkit vNext y Labs. Compara las sintaxis de alertas de GitHub y DocFX mencionadas en la issue y decide después qué formato deberían usar el renderizador y el Markdown existente. Se considera terminado cuando se haya eliminado el aviso de vNext, se renderice de forma coherente en ambos ejemplos y el Markdown relevante de Labs y vNext contenga la sintaxis de alerta elegida.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
csharp, markdown
Área
documentation
Tipo de issue
Nueva funcionalidad
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Estancado
Claridad
Necesita aclaración
Aptitud para principiantes
30/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.