Skip to content

Commit faece3a

Browse files
Update design-principles-ja.html
1 parent 83b342d commit faece3a

File tree

1 file changed

+98
-29
lines changed

1 file changed

+98
-29
lines changed

design-principles-ja.html

Lines changed: 98 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@
116116
●●options
117117

118118
spec_title:Web Platform Design Principles
119-
spec_date:2025-10-28
119+
spec_date:2025-10-29
120120
trans_update:2025-10-31
121121
source_checked:250918
122122
original_url:https://w3ctag.github.io/design-principles/
@@ -454,6 +454,8 @@
454454
~BF~cache:BFCache
455455
WebTransport:
456456
QUIC:
457+
SSL:
458+
TLS:
457459

458460
`IndexedDB-3$r:IndexedDB
459461
`GEOLOCATION$r:Geolocation API
@@ -655,6 +657,7 @@
655657
XSS:
656658
無毒化-:sanitize::~
657659
無毒化器:sanitizer::~
660+
侵害:breach:~
658661
侵害的:invasive:~
659662
Spectre:
660663
開示-:disclose:~
@@ -1126,6 +1129,7 @@
11261129
伝わり:inform
11271130
~~伝える:tell
11281131
不可欠:crucial:~
1132+
利用度:usage:~
11291133

11301134
避けれない:can’t avoid
11311135
~~経験則:rules of thumb
@@ -1394,6 +1398,7 @@
13941398
のみならず:not solely
13951399
に倣って:in line with
13961400
言える:can be said
1401+
現れない:appear
13971402
現れさせ:appear
13981403
にも見える:appear
13991404
生じ易く:prone
@@ -1422,6 +1427,9 @@
14221427
不足なく:sufficient
14231428
無縁:have nothing to do with
14241429
与える:afford
1430+
行うに価するほど:to be worth doing
1431+
標準~化されてない:non-standardized
1432+
にもかかわらず:despite
14251433

14261434
●言い換え
14271435
~~比して過不足がある:does more or less
@@ -1438,6 +1446,7 @@
14381446
縁遠い:less directly connected
14391447
選好する:preference towards
14401448
~~理解し難くなる:harm comprehension
1449+
良く理解する:Gaining a good understanding
14411450
必要なら:presumably
14421451
そのこと:this omission
14431452
一致する:agree
@@ -1615,6 +1624,7 @@
16151624
恒久的:permanent:~
16161625
中断:interruption::~
16171626
音響:sound:~
1627+
archive::::アーカイブ
16181628

16191629
`infinity^jv, `-infinity^jv:infinities
16201630
`infinity^jv, `-infinity^jv:±Infinity
@@ -1703,12 +1713,17 @@
17031713
~~最小限:smallest
17041714
~~最小限:minimal
17051715
少量:least
1716+
ごく少数:tiny
1717+
僅かな:tiny
17061718
少なく:less
17071719
~~増す:larger
17081720
より大きな:larger
17091721
大きく:large
1722+
多数の:large number
1723+
多大な:very large
17101724
のほとんど:mostly
17111725
旧い:older
1726+
旧い:old
17121727
第一に:first
17131728
複数回:more than once
17141729
一回:once
@@ -1732,6 +1747,7 @@
17321747
〜のときも/ときには,:sometimes
17331748
より広い:wider
17341749
広くから:widely
1750+
広く:widely-
17351751
幅広い:wide
17361752
多様な:wide variety of
17371753
いくつかの:a number of
@@ -1943,6 +1959,8 @@
19431959
R. Fielding, Ed.; M. Nottingham, Ed.; J. Reschke, Ed.. <HTTP Semantics>. June 2022. Internet Standard. URL: https://httpwg.org/specs/rfc9110.html
19441960
[SCREEN-CAPTURE]
19451961
Jan-Ivar Bruaroey; Elad Alon. <Screen Capture>. URL: https://w3c.github.io/mediacapture-screen-share/
1962+
[THE-WEB-IS-UNVERSIONED]
1963+
Sangwhan Moon; Amy Guy. <The web is unversioned>. 27 March 2025. TAG Finding. URL: https://www.w3.org/2001/tag/doc/the-web-is-unversioned/
19461964
[UIEVENTS]
19471965
Gary Kacmarcik; Travis Leithead. <UI Events>. URL: https://w3c.github.io/uievents/
19481966
[UNSANCTIONED-TRACKING]
@@ -2792,48 +2810,99 @@ <h3 title="Add new capabilities with care">1.7. 新たな能力は~careの下で
27922810

27932811
</section>
27942812
<section id="removing-features">
2795-
<h3 title="Remove or change capabilities only once you understand existing usage">1.8. 能力を[除去する/変更する]前に既存の用法を理解すること</h3>
2813+
<h3 title="Prioritize compatibility when changing or removing features">1.8. 特能を変更する/除去するときは、互換性を優先すること</h3>
27962814

27972815
<p>
2798-
機能性を[
2799-
除去する/変更する
2800-
]ときは、
2801-
既存の内容との互換性を優先すること。
2816+
ある特能が どう挙動するかを変更する前に,
2817+
~web~siteが現在~それをどう利用しているか理解すること。
28022818
2803-
Prioritize compatibility with existing content when removing or changing functionality.
2819+
Before changing how a feature behaves, understand how websites are currently using it.
28042820
</p>
28052821

28062822
<p>
2807-
有意な量の内容が,特定0の挙動に依存するようになったなら、
2808-
その挙動を[
2809-
除去する/変更する
2810-
]ことは忌避される。
2811-
特能や能力を[
2812-
除去する/変更する
2813-
]ことは,アリだが、
2814-
まずは,[
2815-
既存の内容に対する影響i
2816-
]の資質や視野を理解することが要求される。
2817-
これは、[
2818-
既存の内容が当の特能をどう利用しているか
2819-
]について事実調査が要求されるかもしれない。
2823+
良く理解するためには、
2824+
事実調査が要求されるかもしれない
2825+
— 例えば,[
2826+
広く利用される~UAに【当の特能の利用度に関する】計量を追加する/
2827+
`~HTTP~archiveを探索する@https://har.fyi/guides/getting-started/$
2828+
]ことにより。
2829+
内容を非互換化することは、
2830+
利用者を害する
2831+
— 変更による便益は、
2832+
その害を行うに価するほど有意に勝る必要がある。
2833+
`the-web-is-unversioned$r
28202834
2821-
Once a significant amount of content has come to depend on a particular behavior, removing or changing that behavior is discouraged. Removing or changing features and capabilities is possible, but it first requires that the nature and scope of the impact on existing content is well understood. This might require research into how features are used by existing content.
2835+
Gaining a good understanding might require research, for example by adding metrics to a widely-used user agent or by searching the HTTP Archive. Breaking content harms users, and the benefit of a change has to significantly outweigh that harm to be worth doing [the-web-is-unversioned].
28222836
</p>
28232837

28242838
<p>
28252839
既存の用法を理解する義務は、
2826-
内容が依拠している各~特能にも適用される。
2840+
内容が依拠している[
2841+
標準~化されてない特能/未指定な特能
2842+
]にも適用される。
28272843
これには、
2828-
実装の~bugと見なされるかもしれないような,
2829-
~vendorに~proprietaryな特能や挙動も含まれる。
2830-
~web特能は、
2831-
仕様のみならず[
2832-
そのような特能を内容が どう利用するか
2833-
]によっても定義される。
2844+
~vendorに~proprietaryな特能や実装~bugも含まれる。
2845+
2846+
The obligation to understand existing usage also applies to non-standardized or unspecified features that content relies upon. This includes vendor-proprietary features and implementation bugs.
2847+
</p>
2848+
2849+
<p>
2850+
にもかかわらず、
2851+
多数の~web利用者の体験を改善するために,
2852+
一部の既存の内容を非互換化することが受容-可能になるときもある。
2853+
非互換化は、
2854+
当の[
2855+
特能/挙動
2856+
]に依存する既存の内容が次に挙げるいずれかに該当する場合には,
2857+
もっと受容-可能になる見込みが高い:
28342858
2835-
The obligation to understand existing usage also applies to any features that content relies upon. This includes vendor-proprietary features and behavior that might be considered implementation bugs. Web features are not solely defined in specifications; they are also defined by how content uses those features.
2859+
Despite this, it is sometimes acceptable to break some existing content in order to improve the experience for a large number of web users. Breakage is more likely to be acceptable if:
28362860
</p>
2861+
<ul>
2862+
<li>
2863+
それらは、
2864+
僅かな量に限られる。
2865+
2866+
Only a tiny amount of existing content depend on the feature or behavior.
2867+
</li>
2868+
<li>
2869+
それらを見る人々は、
2870+
ごく少数しかいない。
2871+
2872+
Only a tiny number of people see that content.
2873+
</li>
2874+
<li>
2875+
それらは、
2876+
~test【当の特能や挙動を~testするための】[
2877+
事例/例
2878+
]にしか現れない。
2879+
2880+
The content appears only in test cases or examples.
2881+
</li>
2882+
<li>
2883+
それらは、
2884+
広く利用される一部の~UAにおいて,すでに非互換化されていて、[
2885+
当の~UAは、
2886+
そのことについて多数の~bug報告を受取っていない
2887+
]か[
2888+
当の変更には、
2889+
相互運用能を改善することが期待されている
2890+
]。
2891+
2892+
The content is already broken in some widely-used user agents, and either they have not received many bug reports about it, or the change is expected to improve interoperability.
2893+
</li>
2894+
<li>
2895+
それらを非互換化することには、
2896+
多大な便益がある。
2897+
例えば、
2898+
旧い[
2899+
~SSL/~TLS
2900+
]~versionを除去すると,いくつかの~siteは到達-不能になるが、
2901+
より多くの~security侵害を防止する。
2902+
2903+
The benefit of breaking content is very large. For example, removing old SSL and TLS versions caused a number of sites to become unreachable but prevents more security breaches.
2904+
</li>
2905+
</ul>
28372906

28382907
</section>
28392908
<section id="leave-the-web-better">

0 commit comments

Comments
 (0)