content: Describe why certain implementations (e.g. ion-loading) are described as recommended
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 48/100
- issue の種類
- ドキュメント
- 明瞭さ
- おおむね明確
- 活発さ
- 停滞
調査の方向性
issue にリンクされている ion-loading ドキュメントのセクションから始め、特に inline を推奨するガイダンスを確認し、inline と controller の例をレビューします。inline の実装が推奨される理由を文書化するか、同じ文言で他のコンポーネントもカバーする共通の説明にリンクしてください。
索引モデルが issue の本文から書いたものです。
説明
Describe Problem
For example the documentation of ion-loading describes both an inline and controller implementation, but describes the inline one as recommended without explaining why.
It would be useful to know why this is recommended at this point in the documentation as it may inform your decision about how to implement something. For example, a controller-based implementation of ion-loading may seem preferable to my use case, but if I don't know why an inline implementation is recommended it's harder to make a good choice.
Is this recommendation simply for code clarity, or does it provide a benefit to the end user?
Describe Preferred Solution
I believe there are a few components that have the same description so this could just be a link to a page describing why inline implementations are preferable.
Describe Alternatives
No response
Additional Information
https://ionicframework.com/docs/api/loading#inline-recommended
- 主要言語
- MDX
- スター
- 621
- フォーク
- 3.2k
- 平均マージ
- 1日 2時間
- マージ済み PR（30日）
- 86
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
ionic-team/ionic-docs のほかの issue
-
content
難易度 2/5 1〜3時間 初心者へのやさしさ 86/100
ionic-team/ionic-docs#4705 ·
-
content package: angular
難易度 2/5 半日 初心者へのやさしさ 78/100
ionic-team/ionic-docs#4702 ·
-
triage
難易度 1/5 1時間未満 初心者へのやさしさ 80/100
ionic-team/ionic-docs#4546 ·
-
content: broken link オープンcontent
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
ionic-team/ionic-docs#4381 · コメント 2 件 ·
-
triage
難易度 1/5 1時間未満 初心者へのやさしさ 72/100
ionic-team/ionic-docs#3639 ·
ionic-team/ionic-docs の issue をすべて見る
似ている issue
-
Link Checker Report オープンautomated issue report
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
-
Humanity AI オープン
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
numfocus/project-fundraising#166 ·
-
area:proxy bug security severity:low track:open-source
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100