Improve Problem description for Rectangles

オープン
#2,062 コメント 4 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

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

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
35/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
停滞
領域
documentation

調査の方向性

リポジトリで Rectangles の問題説明と引用された文を検索します。周囲の例と既存の文言を読み、混乱を招く文を曖昧さのないテキストに削除または置き換えます。レンダリングされた説明が、長方形を再定義することなく入力の形状を明確に説明できれば完了です。

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

説明

The Rectangles problem asks users to count the number of rectangles in an array of ASCII text. In the problem description, an illustration of such an array is given, and its valid rectangles are called out.

However, there's a sentence at the end of the problem description that seems unhelpful:

You may assume that the input is always a proper rectangle (i.e. the length of every line equals the length of the first line).

What does this mean? It's confusing because:

  1. The sides of the rectangles do not need to all be equal (that's a square of course, which is a special case of a rectangle.)
  2. The "first line" means what?

I would propose that this sentence simply be removed, since knowing what a rectangle is seems pretty fundamental, and this sentence doesn't make anything clearer. If for some reason there needs to be explanatory text there, I think it should be helpful and unambiguous, perhaps like:

A rectangle's opposite sides will be both parallel and equal to each other in length. A rectangle's adjacent sides may or may not be equal to each other in length. You can see in the above examples that some rectangles have a height that is equal to their width, and some do not.

Or maybe the sentence is intended to convey something different than what a rectangle is? If that's the case, then I still think it could be clarified to communicate whatever is actually intended.

主要言語
Ruby
スター
362
フォーク
566
平均マージ
15時間 13分
マージ済み PR(30日)
8

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

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

exercism/problem-specifications のほかの issue

exercism/problem-specifications の issue をすべて見る

似ている issue

Ruby の issue をもっと見る

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

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