Rust-GPU / Rust-GPU/rust-gpu.github.io

Consider moving the website into main rust-gpu repo

Abierto
#14 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Lenguaje dominante
MDX
Estrellas
16
Forks
8
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

I just threw it in here as that was the quickest way to get the webpage up with github pages.

Docs/website in the main repo:

Pros:

  • Docs stay close to the code, so it’s easier to keep them updated alongside changes.
  • Contributors only need to work in one place, so adding or updating docs is straightforward.
  • No need to manage multiple repos—everything lives together.
    Cons:
  • The repo gets bigger, which can slow down cloning and pull requests for everyone.
  • Mixing code and doc issues in one place can get messy, making it harder to focus on core development.

Using a separate repo for docs/website:

Pros:

  • Keeps the main repo cleaner and code-focused, so it’s easier to navigate.
  • Doc updates are simpler to track and review on their own, without touching the code.
  • Main repo stays leaner and faster to work with.
    Cons:
  • It’s tougher to keep docs in sync with code changes, as they’re in different places.
  • Managing a separate repo adds overhead, like additional issue tracking and reviews.

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Este issue es una propuesta de organización del repositorio, no una tarea de implementación definida. Revisa el repositorio actual del sitio web y el repositorio principal rust-gpu; después, decide dónde deberían ubicarse el sitio web y la documentación. Se considera terminado cuando se haya tomado y registrado una decisión clara, incluido el alcance de cualquier migración.

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

Evaluación

Área
documentation
Tipo de issue
Refactorización
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Estancado
Claridad
Necesita aclaración
Aptitud para principiantes
25/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.