On all-lower-case readability
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 25/100
- issue の種類
- 機能追加
- 明瞭さ
- 説明が足りない
- 活発さ
- 停滞
- 技術スタック
- csharp
調査の方向性
Issue にリンクされている命名規則から始め、Unity の使用例と比較します。特に、大文字と小文字が混在している点や lengthsq のような名前に注目してください。この懸念が具体的な命名変更を求めているのか、それともユーザビリティに関するフィードバックを記録するだけなのかを判断します。完了条件は、対応範囲と maintainer の判断について合意されていることです。
索引モデルが issue の本文から書いたものです。
説明
Hi! I understand the naming convention of all-lowercase provides the benefits as described here. As a counter-balancing point, I just wanted to provide my impression that usability is lowered though when it comes to Unity usage like this
var jobHandle = Entities
.WithName("RotationSpeedSystem_ForEach")
.ForEach((ref Rotation rotation, in RotationSpeed_ForEach rotationSpeed) =>
{
rotation.Value = math.mul
(
math.normalize(rotation.Value),
quaternion.AxisAngle(
math.up(),
rotationSpeed.RadiansPerSecond * deltaTime
)
);
})
.Schedule(inputDependencies);
... where now suddenly, functions are using different case rules. Generally, it's also harder to "parse" in your mind multiple words if they don't use camel-case, e.g. lengthsq contains both the plural "lengths" as well as the intended "length sq". Another stumbling block is generally to have some functions start with a lower-case (this flavor), and others with upper-case (classic Unity), as it makes it harder on the eye to understand what is a function during broad scanning.
Of course, those are just split-seconds reading stumbling blocks, but I'm having flashbacks to how the PHP language grew over time to make different functions use different underscore, case, or haystack-needle parameter ordering rules, increasing usability.
Again, I understand there are benefits to all-lower-case, so please just take it as it is, an impression from a developer, so you can better gauge the costs. The way you chose to do it may still be better in sum.
- 主要言語
- C#
- スター
- 1.4k
- フォーク
- 159
- PR マージ指標
- 30日以内にマージされた PR はありません
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
Unity-Technologies/Unity.Mathematics のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 55/100
-
難易度 4/5 3〜5日 初心者へのやさしさ 45/100
-
難易度 5/5 1週間以上 初心者へのやさしさ 25/100
Unity-Technologies/Unity.Mathematics#245 · コメント 3 件 ·
-
難易度 3/5 1〜2日 初心者へのやさしさ 42/100
Unity-Technologies/Unity.Mathematics#243 · リアクション 6 件 ·
Unity-Technologies/Unity.Mathematics の issue をすべて見る
似ている issue
-
area:frontend bug FE P3
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
klasolsson81/jobbliggaren#2010 ·
メンテナーはふだん 1 日以内に返信
-
agentic-workflows untriaged
難易度 1/5 1時間未満 初心者へのやさしさ 65/100
メンテナーはふだん 1 日以内に返信
-
area: homeblaze type: bug
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
RicoSuter/Namotion.Interceptor#630 ·
メンテナーはふだん 1 日以内に返信
-
Akka.Hosting enhancement
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
-
bug needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
microsoft/microsoft-ui-xaml#12158 ·
メンテナーはふだん 1 日以内に返信