Skip to content

Commit ffbe0e7

Browse files
[design-principles] Add Text: Mitigate defects when extending features. w3ctag/design-principles@e10b073
1 parent 25b4704 commit ffbe0e7

1 file changed

Lines changed: 34 additions & 13 deletions

File tree

design-principles-ja.html

Lines changed: 34 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -117,8 +117,8 @@
117117
●●options
118118

119119
spec_title:Web Platform Design Principles
120-
spec_date:2025-04-30
121-
trans_update:2025-04-30
120+
spec_date:2025-05-16
121+
trans_update:2025-05-17
122122
source_checked:230406
123123
original_url:https://w3ctag.github.io/design-principles/
124124
abbr_url:DESIGN-PRINCIPLES
@@ -982,6 +982,7 @@
982982
妨害-:disrupt:~
983983
難題:challenge:~
984984
欠陥:defect:~
985+
~~欠陥:flaw
985986
品質:quality:~
986987
最悪:worst:~
987988
最悪な場合:at worst
@@ -1032,7 +1033,6 @@
10321033
団体:institution:~
10331034
可用か否か:availability
10341035
保守的:conservative:~
1035-
退行-:degrade:~
10361036
元々は:originalには:~
10371037
減衰-:decline:~
10381038
誤記:typo:~
@@ -1327,6 +1327,9 @@
13271327
透明~:transparency
13281328
~~起因-:originate
13291329
無いに等しく:nothing
1330+
そうすることで:This way,
1331+
抱える:has
1332+
問題になり得る:problematic
13301333

13311334
●言い換え
13321335
~~比して過不足がある:does more or less
@@ -1542,6 +1545,7 @@
15421545
単位が無い:unitless
15431546
増やす:increaseする
15441547
増える:increaseする
1548+
増やさ:increase
15451549
少し増すだけで:small amount of incremental
15461550
いくぶんの:some amount of
15471551
速い:fast
@@ -2524,29 +2528,46 @@ <h3 title="Leave the web better than you found it">1.9. ~webをより良いも
25242528

25252529
<p>
25262530
~web~platformに新たな能力を追加するときは、
2527-
~platformが総合的に改善される仕方で行うこと
2528-
— 例えば、[
2529-
~security/~privacy/~accessibility
2530-
]の特性。
2531+
~platformが総合的に改善される仕方で行うこと。
25312532
2532-
As you add new capabilities to the web platform, do so in a way that improves the overall platform, for example its security, privacy or accessibility characteristics.
2533+
As you add new capabilities to the web platform, do so in a way that improves the overall platform.
25332534
</p>
25342535

25352536
<p>
25362537
~platformの一部に存在する欠陥を当の欠陥に対する[
25372538
追加/拡張
25382539
]の言い訳として利用してはナラナイ
25392540
— そうすると,~platformの品質は総合的に劣化するので。
2541+
2542+
The existence of a defect in one part of the platform must not be used to excuse an addition or extension to the defect, which would further decrease the overall platform quality.
2543+
</p>
2544+
2545+
<p>
2546+
既存の問題になり得る設計~patternとの一貫性は、
2547+
そのような~patternを新たに指定される[
2548+
~Web~API/~platform特能
2549+
]へ伝播する良い理由にはならない。
25402550
新たな~web能力は、
25412551
~platformの品質が総合的に改善されるよう,
25422552
アリな所では既存の欠陥を軽減することにより築くこと。
2543-
良い理由もなく,既存の能力を退行させないこと。
25442553
2545-
The existence of a defect in one part of the platform must not be used to excuse an addition or extension to the defect, which would further decrease the overall platform quality. Where possible, build new web capabilities that improve the overall platform quality by mitigating existing defects. Do not degrade existing capabilities without good reason.
2554+
Consistency with existing problematic design patterns is not a good reason to propagate those patterns in newly specified Web APIs or platform features. Where possible, build new web capabilities that improve the overall platform quality by mitigating existing defects.
2555+
</p>
2556+
2557+
<p>
2558+
既知な欠陥を抱える~platform特能を拡張する際には、
2559+
当の欠陥に取組む方法を考慮すること。
2560+
既存の問題を完全に修正することは必要yでないが、
2561+
既知な課題を伴う特能を拡張するときには,~~欠陥に取組む何らかの試みが期待される。
2562+
そうすることで、[
2563+
新たな/増やされた
2564+
]用法は,当の欠陥が原因かもしれない害を増やさないようになる。
2565+
2566+
Do not extend a platform feature that has known defects, without considering how to address those defects. It is not necessary to completely fix existing problems, but some attempt to address flaws is expected when extending a feature with known issues. This way, new or increased usage does not result in increasing the harm that the defect might cause.
25462567
</p>
25472568

25482569
<p>
2549-
~web~platformの各部は
2570+
~web~platformを成す各部は
25502571
独立に発展する。
25512572
ある種の~web技術に今在る課題は、
25522573
後続な~~版において修正され得る。
@@ -4012,7 +4033,7 @@ <h3 title="Use space-separated attributes for short lists of values, separate el
40124033
</div>
40134034

40144035
<p>
4015-
~web~platformの他の各部との一貫性は重要である
4036+
~web~platformを成す他の各部との一貫性は重要である
40164037
— これが,[
40174038
値どうしを別の文字を利用して分離する
40184039
]ことを意味する場合でも。
@@ -8925,7 +8946,7 @@ <h4 title="Define algorithms clearly">11.2.1. ~algoを明瞭に定義するこ
89258946
`showModal()@~HEinteractive#dom-dialog-showmodal$c
89268947
~methodは、
89278948
付番された一連の段として述べられ,[
8928-
例外をいつ投出して,~HTML仕様の他の各部にて定義される~algoをいつ走らすか
8949+
例外をいつ投出して,~HTML仕様を成す他の各部にて定義される~algoをいつ走らすか
89298950
]を明瞭に説明する。
89308951
89318952
The showModal() method is described as a numbered sequence of steps which clearly explains when to throw exceptions and when to run algorithms defined in other parts of the HTML spec.

0 commit comments

Comments
 (0)