how to talk about relevant crates
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 25/100
- Tipo de issue
- Documentación
- Claridad
- Necesita aclaración
- Estado de actividad
- Estancado
- Stack tecnológico
- rust
- Área
- cli, documentation
Línea de trabajo
Lee primero la discusión enlazada en PR #157 y la sección Useful crates del libro. La tarea estará terminada cuando se haya elegido y documentado una política —delegar, enumerar o debatir las crates relevantes— y se haya actualizado en consecuencia la sección correspondiente del libro.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
from: https://github.com/rust-cli/book/pull/157#discussion_r947838706
So far, we only list out crates we directly use. We might want to give more thought to how we would want t talk about relevant crates more generally.
Choices
I can see three main choices:
-
Delegate: Don't talk about crates at all and link to other resouces.
- Link to the crates you use directly in the sections where you use them.
- Reduce the Useful crates section to links pointing to e.g. https://github.com/rust-unofficial/awesome-rust#command-line and/or https://lib.rs.
-
List: Just list crates without discussion of differences between crates of the same domain.
- (Domain as in e.g. pretty-printing table crates, or argument parser crates.)
- Con: competition with awesome-rust et al. lists / duplicated effort. (but these other lists could be assimilated/consolidated here)
- Pro: You'd have everything in one place, i.e. if you'd wanna know/learn about CLI in Rust, this book would always be the go to resource. (which it isn't at the moment because the useful crates section is neither exhaustive nor does it discuss crates in the same domain)
-
Discuss: List and discuss the relevant crates in their respective domain.
- Let awesome-rust et al. be the short list version. Extend on a simple listing by discussing differences between crates in the same domain, e.g. when would I use clap over any of the other argument parsing libs out there and when would I use any of the other libs.
- This could be organized in sub sections of Useful crates, i.e. keep the main Useful crates page as is, and add a subsection for each domain.
- Lenguaje dominante
- Rust
- Estrellas
- 1.1k
- Forks
- 122
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Preparar el entorno
Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de rust-cli/book
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 68/100
-
Broken Discord linkAbierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 35/100
-
documentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 45/100
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 35/100
-
bug
Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100
Todos los issues de rust-cli/book
Issues similares
-
ai-priority/P2 bug db/oracle user-priority/P1
Dificultad 2/5 1-3 horas Aptitud para principiantes 67/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
servo/mozjs#831 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
swc-project/swc#12516 ·
Los mantenedores suelen responder en 1 día
-
app bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100