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

Consider moving the website into main rust-gpu repo

オープン
#14 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

主要言語
MDX
スター
16
フォーク
8
PR マージ指標
30日以内にマージされた PR はありません

説明

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.

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

この Issue は、明確に定義された実装タスクではなく、リポジトリ構成に関する提案です。現在の website repository とメインの rust-gpu repository を確認し、そのうえで website とドキュメントをどこに置くべきかを決定してください。完了とは、移行の範囲を含め、明確な決定に到達して記録することです。

索引モデルが issue の本文から書いたものです。

評価

領域
documentation
issue の種類
リファクタリング
難易度
5/5
見積もり時間
1週間以上
活発さ
停滞
明瞭さ
説明が足りない
初心者へのやさしさ
25/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。