このドキュメントについて

• 1: 著作権と帰属
• 2: Seleniumのサイトとドキュメントに貢献する
• 3: Style guide for Selenium documentation

1 - 著作権と帰属

Seleniumのドキュメント

このドキュメントをできるだけ完全かつ正確にするためにあらゆる努力が払われましたが、 保証または適合性は暗示されていません。 提供される情報は「現状のまま」です。 著者および出版社は、本書に含まれる情報から生じる損失または損害に関して、 いかなる個人または団体に対しても責任も責任も負わないものとします。 ここに含まれる情報の使用に関して、特許責任は一切負いません。

帰属

Thanks to:

Selenium メイン Repository

@shs96c 5115 commits

@barancev 3352 commits

@jimevans 2459 commits

@jleyba 1464 commits

@jarib 1299 commits

@AutomatedTester 1207 commits

@dfabulich 1175 commits

@illicitonion 1162 commits

@titusfortner 1003 commits

@diemol 860 commits

@lukeis 599 commits

@p0deje 493 commits

@eranmes 473 commits

@mdub 326 commits

@pujagani 301 commits

@andreastt 289 commits

@krosenvold 225 commits

@hugs 205 commits

@davehunt 200 commits

@hbchai 191 commits

@lmtierney 179 commits

@symonk 171 commits

@harsha509 162 commits

@freynaud 138 commits

@samitbadle 137 commits

@nirvdrum 133 commits

@sevaseva 115 commits

@gigix 109 commits

@juangj 108 commits

@aslakhellesoy 94 commits

@alex-savchuk 90 commits

@andrashatvani 66 commits

@bonigarcia 66 commits

@ajayk 63 commits

@twalpole 49 commits

@asashour 48 commits

@mikemelia 46 commits

@tebeka 44 commits

@raju249 42 commits

@santiycr 41 commits

@luke-hill 40 commits

@mach6 36 commits

@dependabot[bot] 34 commits

@valfirst 33 commits

@ddavison 32 commits

@joshbruning 30 commits

@mikebroberts 28 commits

@JohnChen0 26 commits

@krmahadevan 23 commits

@alb-i986 22 commits

@bret 20 commits

@cgoldberg 20 commits

@corevo 20 commits

@Stuk 19 commits

@TamsilAmani 19 commits

@rbri 16 commits

@bwalderman 15 commits

@asolntsev 13 commits

@joerg1985 13 commits

@bayandin 12 commits

@carlosgcampos 12 commits

@jayakumarc 12 commits

@potapovDim 12 commits

@43081j 11 commits

@detro 10 commits

@josephg 10 commits

@nvborisenko 10 commits

@redsquirrel 9 commits

@isaulv 9 commits

@hoefling 9 commits

@RustyNail 9 commits

@glibas 7 commits

@SinghHrmn 7 commits

@llaskin 7 commits

@DrMarcII 7 commits

@mmerrell 7 commits

@User253489 7 commits

@dratler 7 commits

@dima-groupon 6 commits

@nikolas 6 commits

@shucon 6 commits

@whimboo 6 commits

@iampopovich 5 commits

@cclauss 5 commits

@gpt14 5 commits

@Herst 5 commits

@jimvm 5 commits

@JohanLorenzo 5 commits

@mdmintz 5 commits

@nschonni 5 commits

@seanpoulter 5 commits

@oddui 5 commits

@adiohana 5 commits

@Zitrax 4 commits

@dbo 4 commits

@Dharin-shah 4 commits

@xaircore 4 commits

@bongosway 4 commits

@sangaline 4 commits

@guangyuexu 4 commits

Selenium IDE

@corevo 2445 commits

@toddtarsi 161 commits

@baimao8437 88 commits

@coinzdude 54 commits

@Jongkeun 51 commits

@petermouse 36 commits

@LinYunWen 36 commits

@zavelevsky 34 commits

@dependabot[bot] 24 commits

@xdennisx 15 commits

@AutomatedTester 15 commits

@raju249 12 commits

@smildlzj 11 commits

@diemol 6 commits

@manoj9788 3 commits

@Rowdster 3 commits

@shs96c 3 commits

@zewa666 3 commits

@Angus3280 2 commits

@giuliohome 2 commits

@lukeis 2 commits

@Meir017 2 commits

@toshiya 2 commits

@marknoble 2 commits

@amitzur 1 commits

@aplorenzen 1 commits

@atkulp 1 commits

@cliftonHPE 1 commits

@dvd900 1 commits

@furkanakkurt1335 1 commits

@p2635 1 commits

@sotayamashita 1 commits

@samitbadle 1 commits

@harsha509 1 commits

@swes1117 1 commits

@vivrichards600 1 commits

@bolasblack 1 commits

@peter-kehl 1 commits

Docker Selenium

@diemol 502 commits

@ddavison 134 commits

@selenium-ci 101 commits

@mtscout6 53 commits

@kayabendroth 50 commits

@dependabot[bot] 25 commits

@elgalu 24 commits

@jamesmortensen 10 commits

@WillAbides 8 commits

@jsa34 7 commits

@marten-cz 5 commits

@MacCracken 5 commits

@garagepoort 4 commits

@metajiji 4 commits

@luisfcorreia 4 commits

@manoj9788 4 commits

@Xcalizorz 4 commits

@ZainabSalameh 4 commits

@chenrui333 4 commits

@niQo 4 commits

@testphreak 4 commits

@abaldwin-op 3 commits

@Remi-p 3 commits

@tnguyen14 3 commits

@alexgibson 3 commits

@jeff-jk 3 commits

@pabloFuente 3 commits

@adriangonciarz 2 commits

@ilpianista 2 commits

@chuckg 2 commits

@davehunt 2 commits

@den-is 2 commits

@therealdjryan 2 commits

@AutomationD 2 commits

@ehbello 2 commits

@efranken 2 commits

@glibas 2 commits

@joaoluizjoaquim 2 commits

@mathieu-pousse 2 commits

@mhnaeem 2 commits

@naveensrinivasan 2 commits

@phensley 2 commits

@anthonybaldwin 2 commits

@ryneeverett 2 commits

@wheleph 2 commits

@budtmo 2 commits

@evertones 2 commits

@kmala 2 commits

@schmunk42 2 commits

@a-k-g 1 commits

@adrianhj 1 commits

@alexkogon 1 commits

@lorantalas 1 commits

@v1-wizard 1 commits

@sahajamit 1 commits

@AndreasPetersen 1 commits

@DamianFekete 1 commits

@deviantintegral 1 commits

@Grisu118 1 commits

@gensc004 1 commits

@charford 1 commits

@cyrille-leclerc 1 commits

@Dan-DeAraujo 1 commits

@germetist 1 commits

@theddub 1 commits

@deiwin 1 commits

@enolan 1 commits

@glogiotatidis 1 commits

@hbouhadji 1 commits

@hnryjms 1 commits

@doublemarket 1 commits

@hazmeister 1 commits

@jamesottaway 1 commits

@jarspi 1 commits

@JasonBerenbach 1 commits

@BeyondEvil 1 commits

@ja8zyjits 1 commits

@jwhitlock 1 commits

@jonaseicher 1 commits

@CaffeinatedCM 1 commits

@lcnja 1 commits

@krmahadevan 1 commits

@lmtierney 1 commits

@lukeis 1 commits

@manusa 1 commits

@marvinruder 1 commits

@m15o 1 commits

@matzegebbe 1 commits

@michallepicki 1 commits

@mikewrighton 1 commits

@meeroslaph 1 commits

@double16 1 commits

@PDUBEY00 1 commits

@reinholdfuereder 1 commits

@rerakers 1 commits

@rjatkins 1 commits

@nwtgck 1 commits

@tuxiqae 1 commits

@cablespaghetti 1 commits

@scottturley 1 commits

Selenium Website & Docs

@diemol 631 commits

@harsha509 577 commits

@selenium-ci 323 commits

@titusfortner 118 commits

@alaahong 101 commits

@kzhirata 47 commits

@pujagani 39 commits

@boris779 32 commits

@alenros 28 commits

@AlexAndradeNet 25 commits

@manoj9788 21 commits

@jmartinezpoq 18 commits

@AutomatedTester 18 commits

@ivanrodjr 17 commits

@luisfcorreia 13 commits

@bonigarcia 12 commits

@sindhudiddi 12 commits

@shs96c 11 commits

@hiroksarker 10 commits

@pallavigitwork 10 commits

@github-actions[bot] 9 commits

@nwintop 8 commits

@tetration 7 commits

@dependabot[bot] 7 commits

@testbot206 6 commits

@connerT 6 commits

@Greavox 6 commits

@liushilive 6 commits

@hanceanic 6 commits

@Dor-bl 5 commits

@krmahadevan 5 commits

@nainappa 5 commits

@hyanx 5 commits

@lvninety 5 commits

@Catalin-Negru 5 commits

@davieduardo94 5 commits

@abhi2810 4 commits

@barancev 4 commits

@angelovstanton 4 commits

@wcmcgee 4 commits

@kjayachandra2000 4 commits

@peter-kinzelman 4 commits

@TamsilAmani 4 commits

@ant9112 4 commits

@deining 4 commits

@Crank4098 3 commits

@Arc-Jung 3 commits

@ArCiGo 3 commits

@gnatcatcher-bg 3 commits

@effeix 3 commits

@jags14385 3 commits

@jamesmortensen 3 commits

@jasonren0403 3 commits

@j3soon 3 commits

@mmerrell 3 commits

@Madh93 3 commits

@rajeevbarde 3 commits

@raju249 3 commits

@takeya0x86 3 commits

@TestOpsCloudchen 3 commits

@cambiph 3 commits

@twinstae 3 commits

@Tolerblanc 3 commits

@beatfactor 2 commits

@iambocai 2 commits

@Bredda 2 commits

@cjayswal 2 commits

@bongosway 2 commits

@SinghHrmn 2 commits

@kapilyadav1204 2 commits

@mookkiah 2 commits

@palotas 2 commits

@miekof 2 commits

@naeemakram 2 commits

@natanportilho 2 commits

@rahuljhakant 2 commits

@urig 2 commits

@sridhar-5 2 commits

@YoshikiIto 2 commits

@ilhanoztozlu 2 commits

@coodjokergl 2 commits

@sangheon4353 2 commits

@selectorshubsanjay 2 commits

@the-ruffian 2 commits

@imba-tjd 2 commits

@0420syj 2 commits

@TheTestLynx 2 commits

@k19810703 2 commits

@ajsdecode 1 commits

@abhishek-malani 1 commits

@adithyab94 1 commits

@alexako 1 commits

@vinogradoff 1 commits

@amarr1143l 1 commits

@amiluslu 1 commits

@amirmojiry 1 commits

@sahajamit 1 commits

@ankitkumar734ac 1 commits

@fiveych 1 commits

@Archibaald-dev 1 commits

Previous Selenium Website

@lukeis 417 commits

@shs96c 87 commits

@pgrandje 79 commits

@barancev 63 commits

@lightbody 59 commits

@ajayk 40 commits

@tarun3kumar 40 commits

@ddavison 36 commits

@davehunt 26 commits

@manoj9788 24 commits

@peter-kehl 22 commits

@lmtierney 21 commits

@samitbadle 21 commits

@santiycr 19 commits

@illicitonion 17 commits

@pnewhook 14 commits

@AutomatedTester 12 commits

@rasmusbergpalm 11 commits

@juangj 11 commits

@lukeis-sfdc 10 commits

@andreastt 7 commits

@hugs 6 commits

@jarib 5 commits

@jimevans 5 commits

@llaskin 5 commits

@PaulKC 5 commits

@titusfortner 5 commits

@corevo 5 commits

@diemol 3 commits

@asashour 2 commits

@oleksandr-lobunets 2 commits

@alex-savchuk 2 commits

@javabrett 2 commits

@darrincherry 2 commits

@eranmes 2 commits

@hazmeister 2 commits

@julianharty 2 commits

@mikemelia 2 commits

@paul-hammant 2 commits

@labkey-tchad 2 commits

@abhijain2618 2 commits

@agabrys 1 commits

@azawawi 1 commits

@alb-i986 1 commits

@hollingsworthd 1 commits

@dylans 1 commits

@EmidioStani 1 commits

@FagnerMartinsBrack 1 commits

@Xaeroxe 1 commits

@JamesZoft 1 commits

@jleyba 1 commits

@JustAGuyTryingToCodeSomething 1 commits

@kdamball 1 commits

@laurinkeithdavis 1 commits

@klamping 1 commits

@krmahadevan 1 commits

@krosenvold 1 commits

@mmerrell 1 commits

@grawk 1 commits

@mcavigelli 1 commits

@michaelwowro 1 commits

@muralidharand 1 commits

@meeroslaph 1 commits

@NickAb 1 commits

@ohadschn 1 commits

@oifland 1 commits

@rbri 1 commits

@roydekleijn 1 commits

@QuinnWilton 1 commits

@smatei 1 commits

@harrissAvalon 1 commits

@SteveDesmond-ca 1 commits

@Vimal-N 1 commits

@yasinguzel 1 commits

@tobecrazy 1 commits

@Zearin 1 commits

@beckendorff 1 commits

@daveOrleans 1 commits

@androiddriver 1 commits

@mauk81 1 commits

@pharry22 1 commits

@prab2112 1 commits

@refactoror 1 commits

@rogerdc 1 commits

@tibord 1 commits

@ygmarchi 1 commits

Previous Documentation Rewrite Project

@andreastt 197 commits

@selenium-ci 105 commits

@diemol 54 commits

@hazmeister 30 commits

@santiycr 27 commits

@AlexAndradeNet 25 commits

@lukeis 21 commits

@harsha509 17 commits

@ddavison 16 commits

@davehunt 12 commits

@manoj9788 12 commits

@orieken 12 commits

@djangofan 12 commits

@liushilive 8 commits

@User253489 7 commits

@jimholmes 6 commits

@imba-tjd 6 commits

@mmerrell 6 commits

@shs96c 6 commits

@picimako 5 commits

@vijay44 5 commits

@cambiph 5 commits

@nvonop 4 commits

@rivlinp 4 commits

@sheg 4 commits

@bizob2828 4 commits

@detro 3 commits

@Ardesco 3 commits

@TheTestLynx 3 commits

@boris779 2 commits

@Bredda 2 commits

@juperala 2 commits

@lmtierney 2 commits

@systemboogie 2 commits

@palotas 2 commits

@miekof 2 commits

@sri85 2 commits

@hoanluu 2 commits

@ilhanoztozlu 2 commits

@paul-barton 2 commits

@adithyab94 1 commits

@alenros 1 commits

@p0deje 1 commits

@AJ-72 1 commits

@abotalov 1 commits

@bhardin 1 commits

@chamiz 1 commits

@dennybiasiolli 1 commits

@donhuvy 1 commits

@bongosway 1 commits

@nicegraham 1 commits

@austenjt 1 commits

@kmcgon 1 commits

@MartinDelille 1 commits

@michael-coleman 1 commits

@misiekofski 1 commits

@MilanMasek 1 commits

@rakib-amin 1 commits

@NRezek 1 commits

@nikai3d 1 commits

@OndraM 1 commits

@sourabhkt 1 commits

@whhone 1 commits

@yarix 1 commits

@ZbigniewZabost 1 commits

@agmen 1 commits

@hking-shutterfly 1 commits

@jimevans 1 commits

@948462448 1 commits

@marilyn 1 commits

@riccione 1 commits

@tungla 1 commits

@zeljkofilipin 1 commits

Seleniumドキュメントプロジェクトで使用されるサードパーティソフトウェア

ライセンス

Seleniumプロジェクトから作成されたすべてのコードとドキュメントは、 Apache 2.0ライセンスに基づいてライセンスされており、 Software Freedom Conservancy に著作権があります。

ライセンスは便宜上ここに含まれていますが、 Apache FoundationのWebサイトでも見つけることができます。

                                 Apache License
                           Version 2.0, 2004年1月
                        http://www.apache.org/licenses/

   使用、複製、および頒布に関する条項

   1. 定義 　

      「ライセンス」とは、このドキュメントの第1項から第9項までで定義している、
      使用、複製、および頒布に関する条項を指します。

      「ライセンサー」とは、著作権所有者、あるいは著作権所有者が
      ライセンス付与対象として認めた者を指します。

      「法人」とは、行為者と、行為者を管理するか行為者により管理されるか
      行為者共通の管理下にある他のすべての者とから成る連合体を指します。
      この定義における「管理」とは、
      (i) 契約またはその他により、直接または間接的にこの法人の指揮・経営を行う権限、または
      (ii) この法人の50%以上の株式の所有権 または
      (iii) 受益所有権を有することを指します。

      「あなた」とは、本ライセンスにより付与される権利を行使する個人または法人を指します。

      「ソース」形式とは、ソフトウェアのソースコード、ドキュメントソース、
      設定ファイルといった、変更を加えるのに好都合な形式を指します。

      「オブジェクト」形式とは、コンパイルされたオブジェクトコード、生成されたドキュメント、
      他のメディアへの変換物といった、ソース形式の機械的な変換により生じる形式を指します。

      「成果物」とは、ソース形式であるとオブジェクト形式であるとを問わず、
      製作物に挿入または添付される（後出の付録に例がある）著作権表示で示された著作物で、
      本ライセンスに基づいて利用が許されるものを指します。

      「派生成果物」とは、編集上の改訂、注解、推敲など、
      成果物を基にしていて全体としてオリジナル著作物と呼べるような製作物全般を指します。
      本ライセンスでは、成果物や派生成果物から分離できる製作物や、
      成果物や派生成果物のインタフェースへの単なるリンク（または名前によるバインド）を、
      派生成果物に含めません。

      「コントリビューション」とは、成果物のオリジナルバージョンならびに成果物
      または派生成果物への変更や追加も含めて、著作権所有者あるいは著作権所有者が認めた
      個人または法人による成果物への組み込みを意図してライセンサーに提出される
      著作物全般を指します。
      この定義における「提出」とは、成果物を論じたり改良するためにライセンサー
      またはその代理者により管理される電子的メーリングリスト、ソースコード管理システム、
      問題追跡システムといった、電子的方法、口頭、または書面で、
      ライセンサーまたはその代理者に情報を送ることを指します。
      ただし、著作権所有者が書面で「コントリビューションでない」と明示したものは除きます。

      「コントリビューター」とは、ライセンサーおよびその代理を務める個人または法人で、
      自分のコントリビューションがライセンサーに受領されて成果物に組み込まれた者を指します。

   2. 著作権ライセンスの付与  
      本ライセンスの条項に従って、各コントリビューターはあなたに対し、
      ソース形式であれオブジェクト形式であれ、成果物および派生成果物を複製したり、
      派生成果物を作成したり、公に表示したり、公に実行したり、サブライセンスしたり、
      頒布したりする、無期限で世界規模で非独占的で使用料無料で取り消し不能な
      著作権ライセンスを付与します。

   3. 特許ライセンスの付与  
      本ライセンスの条項に従って、各コントリビューターはあなたに対し、
      成果物を作成したり、使用したり、販売したり、販売用に提供したり、
      インポートしたり、その他の方法で移転したりする、
      無期限で世界規模で非独占的で使用料無料で取り消し不能な
      （この項で明記したものは除く）特許ライセンスを付与します。
      ただし、このようなライセンスは、コントリビューターによって
      ライセンス可能な特許申請のうち、当該コントリビューターのコントリビューションを
      単独または該当する成果物と組み合わせて用いることで必然的に侵害されるものにのみ
      適用されます。
      あなたが誰かに対し、交差請求や反訴を含めて、
      成果物あるいは成果物に組み込まれたコントリビューションが
      直接または間接的な特許侵害に当たるとして特許訴訟を起こした場合、
      本ライセンスに基づいてあなたに付与された特許ライセンスは、
      そうした訴訟が正式に起こされた時点で終了するものとします。

   4. 再頒布  
      あなたは、ソース形式であれオブジェクト形式であれ、変更の有無に関わらず、
      以下の条件をすべて満たす限りにおいて、成果物またはその派生成果物のコピーを
      複製したり頒布したりすることができます。

      (a) 成果物または派生成果物の他の受領者に本ライセンスのコピーも渡すこと。

      (b) 変更を加えたファイルについては、あなたが変更したということが
      よくわかるような告知を入れること。

      (c) ソース形式の派生成果物を頒布する場合は、ソース形式の成果物に含まれている著作権、
      特許、商標、および帰属についての告知を、派生成果物のどこにも関係しないものは除いて、
      すべて派生成果物に入れること。

      (d) 成果物の一部として「NOTICE」に相当するテキストファイルが含まれている場合は、
      そうしたNOTICEファイルに含まれている帰属告知のコピーを、
      派生成果物のどこにも関係しないものは除いて、頒布する派生成果物に入れること。
      その際、次のうちの少なくとも1箇所に挿入すること。
      (i) 派生成果物の一部として頒布するNOTICEテキストファイル、
      (ii) ソース形式またはドキュメント（派生成果物と共にドキュメントを頒布する場合）、
      (iii) 派生成果物によって生成される表示
      （こうした第三者告知を盛り込むことが標準的なやり方になっている場合）。
      NOTICEファイルの内容はあくまで情報伝達用であって、
      本ライセンスを修正するものであってはなりません。
      あなたは頒布する派生成果物に自分の帰属告知を
      （成果物からのNOTICEテキストに並べて、またはその付録として）追加できますが、
      これはそうした追加の帰属告知が本ライセンスの修正と
      解釈されるおそれがない場合に限られます。

      あなたは自分の修正物に自らの著作権表示を追加することができ、
      自分の修正物の使用、複製、または頒布について、あるいはそうした派生成果物の全体について、
      付加的なライセンス条項または異なるライセンス条項を設けることができます。
      ただし、これは成果物についてのあなたの使用、複製、および頒布が、
      それ以外の点で本ライセンスの条項に従っている場合に限られます。

   5. コントリビューションの提出  
      特に断りがない限り、あなたが成果物への組み込みを意図してライセンサーに
      提出したコントリビューションは、付加的な条項がなければ、
      本ライセンスの条項に従うものとします。
      上述の規定にかかわらず、そうしたコントリビューションに関してあなたがライセンサーと
      結んだかもしれない別のライセンス契約の条項を、ここで無効にしたり
      修正したりすることはありません。

   6. 商標  
      本ライセンスでは、成果物の出所を記述したりNOTICEファイルの内容を複製するときに
      必要になる妥当で慣習的な使い方は別として、ライセンサーの商号、商標、サービスマーク、
      または製品名の使用権を付与しません。

   7. 保証の否認  
      適用される法律または書面での同意によって命じられない限り、
      ライセンサーは成果物を（そしてコントリビューターは各自のコントリビューションを）
      「現状のまま」提供するものとし、明示黙示を問わず、タイトル、非侵害性、
      商業的な使用可能性、および特定の目的に対する適合性を含め、
      いかなる保証も条件も提供しません。
      あなたは成果物の使用や再頒布の適切性を自分で判断する責任を持つと共に、
      本ライセンスにより付与される権利を行使することに伴うすべてのリスクを負うことになります。

   8. 責任の制限  
      いかなる条件および法理論においても、不法行為（過失を含む）、契約、
      またはその他いかなる場合でも、適用される法律または書面での同意によって命じられない限り、
      コントリビューターは本ライセンスまたは成果物の使い方に関連して生じる直接損害、
      間接損害、偶発的な損害、特別損害、懲罰的損害、または結果損害を含め、
      営業権の損失、業務の停止、コンピューター障害または誤作動、
      その他の商業上の損害や損失など、いかなる損害に対しても、
      たとえそうした損害の可能性をたとえ知らされていたとしても、
      あなたに責任を負わないものとします。

   9. 保証または追加的責任の引き受け  
      成果物またはその派生成果物を再頒布する際、あなたはサポート、保証、損害補償、
      またはその他の責任や、本ライセンスに矛盾しない権利を提示し、
      これを有料にすることができます。
      ただし、そうした責任を引き受ける場合、あなたはそれを自分自身のためにだけ
      自己責任として行えるのであって、他のコントリビューターのために行うことはできません。
      また、あなたはそうした保証や追加的責任のせいで他のコントリビューターに
      責任が降りかかったり賠償要求が出されたとしても、それらのコントリビューターに
      損害が及ぶのを防ぐと共に各コントリビューターの損害を補償することに同意しなければなりません。

   使用、複製、および頒布に関する条項の終わり

   付録： Apache Licenseの適用の仕方

      あなたの製作物にApache Licenseを適用するときは、次の定型文を添付してください。
      ただし、"[]"で囲まれている部分は、あなた自身の識別情報に置き換えてください
      （その際、角括弧は取り除きます）。
      また、この文言を該当するファイル形式に合ったコメント構文で囲んでください。
      さらに、第三者アーカイブ内での識別を容易にするため、
      ファイル名またはクラス名ならびに趣旨説明が著作権表示と同じ「印刷ページ」に
      現れるようにすることをお勧めします。

   Copyright [yyyy] [著作権所有者の名前]

   Apache License Version 2.0（「本ライセンス」）に基づいてライセンスされます。
   あなたがこのファイルを使用するためには、本ライセンスに従わなければなりません。
   本ライセンスのコピーは下記の場所から入手できます。

       http://www.apache.org/licenses/LICENSE-2.0

   適用される法律または書面での同意によって命じられない限り、
   本ライセンスに基づいて頒布されるソフトウェアは、明示黙示を問わず、
   いかなる保証も条件もなしに「現状のまま」頒布されます。
   本ライセンスでの権利と制限を規定した文言については、本ライセンスを参照してください。

2 - Seleniumのサイトとドキュメントに貢献する

Seleniumは大きなソフトウェアプロジェクトであり、そのサイトとドキュメントは、物事の仕組みを理解し、その可能性を活用する効果的な方法を学ぶための鍵となります。

このプロジェクトには、Seleniumのサイトとドキュメントの両方が含まれています。これは、Seleniumを効果的に使用する方法、Seleniumに参加する方法、およびSeleniumに貢献する方法に関する最新情報を提供するための継続的な取り組みです（特定のリリースを対象としていません）。

サイトおよびドキュメントへの貢献は、以下のセクションで説明されているプロセスに従います。

Seleniumプロジェクトは、皆様からのコントリビューションを歓迎します。 お手伝いをいただくには、いくつかの方法があります:

イシュー報告

新しい問題を報告したり、既存の問題についてコメントしたりするときは、議論がSeleniumソフトウェア、そのサイトおよび/またはドキュメントに関する具体的な技術問題に関連していることを確認してください。

Seleniumのすべてのコンポーネントは、時間の経過とともに非常に速く変化するため、ドキュメントが古くなる可能性があります。 このようなケースを見つけた場合には、遠慮なくイシューを作成してください。 また、ドキュメントを最新の状態に更新する方法をご存知でしたら、関連する変更を含むプルリクエストを送ってしてください。

見つかったものが問題であるかどうかわからない場合、https://selenium.dev/supportに記載されているコミュニケーション手段にて質問してください。

貢献

Seleniumプロジェクトは新しいコントリビュータを歓迎します。目立った価値ある貢献を継続的に行った個人は コミッター として認められ、プロジェクトへのコミットアクセス件が与えられます。

本ガイドでは、貢献のプロセスについて説明します。

ステップ 1: フォーク

Github上のプロジェクトをフォークし、コピーをローカルにチェックアウトしてください。

% git clone git@github.com:seleniumhq/seleniumhq.github.io.git
% cd seleniumhq.github.io

依存関係: Hugo

We use Hugo and the Docsy theme to build and render the site. You will need the “extended” Sass/SCSS version of the Hugo binary to work on this site. We recommend to use Hugo 0.101.0 or higher.

Please follow the Install Hugo instructions from Docsy.

ステップ 2: ブランチの作成

フィーチャーブランチを作成し、ハックを開始します。:

% git checkout -b my-feature-branch

我々はHEADベースの開発を行っています。つまり、全ての変更はtrunkブランチ上に直接適用されます。

ステップ 3: 変更を加える

The repository contains the site and docs. Before jumping into making changes, please initialize the submodules and install the needed dependencies (see commands below). To make changes to the site, work on the website_and_docs directory. To see a live preview of your changes, run hugo server on the site’s root directory.

% git submodule update --init --recursive
% cd website_and_docs
% hugo server

See Style Guide for more information on our conventions for contribution

ステップ 4: コミット

まず、gitがあなたの名前とメールアドレスを知っていることを確認してください:

% git config --global user.name 'Santa Claus'
% git config --global user.email 'santa@example.com'

**適切なコミットメッセージを書くことは重要です。**コミットメッセージには、変更された内容、理由、修正されたイシューへの参照（ある場合）を記述する必要があります。作成するときは、次のガイドラインに従ってください。:

1. 最初の行は約50文字以下で、変更の簡単な説明を含める必要があります。
2. 2行目は空白のままにします。
3. 他のすべての行を72列で折り返します。
4. Fixes #Nを含めてください。ここでは N がこのコミットで修正したイシュー番号です（存在する場合）。

適切なコミットメッセージは次のようになります:

explain commit normatively in one line

Body of commit message is a few lines of text, explaining things
in more detail, possibly giving some background about the issue
being fixed, etc.

The body of the commit message can be several paragraphs, and
please do proper word-wrap and keep columns shorter than about
72 characters or so. That way `git log` will show things
nicely even when it is indented.

Fixes #141

最初の行はgit shortlogやgit log --onelineを実行した際に他人が最初に目にするため、意味のあるものでなければなりません。

ステップ 5: リベース

あなたの作業を同期するため、(git mergeではなく)git rebaseを時々実行してください。

% git fetch origin
% git rebase origin/trunk

ステップ 6: テスト

あなたの変更が何も問題を起こしていないことを確認するため、常に忘れずにローカルサーバーの実行を行ってください。

ステップ 7: プッシュ

% git push origin my-feature-branch

https://github.com/yourusername/seleniumhq.github.io.git を開き、_Pull Request_を押し、フォームを入力してください。 CLAに署名したことを示してください (ステップ7を参照)

プルリクエストは通常数日以内にレビューされます。対応すべきコメントがある場合は、新しく(できれば fixupsで)コミットし、同じブランチにプッシュしてください。

ステップ 8: 統合

コードレビューが完了すると、コミッターがPRを取得し、リポジトリのtrunkブランチに統合します。 マスターブランチで履歴を線形に保持するのが好きなので、通常はブランチの履歴をスカッシュしてリベースします。

コミュニケーション

プロジェクトのコントリビューターおよびコミュニティ全体と交流する方法については、全て https://selenium.dev/support で詳細が記載されています。

3 - Style guide for Selenium documentation

Read our contributing documentation for complete instructions on how to add content to this documentation.

Alerts

Alerts have been added to direct potential contributors to where specific help is needed.

When code examples are needed, this code has been added to the site:

{{< alert-code />}}

Which gets displayed like this:

To specify what code is needed, you can pass information inside the tag:

{{< alert-code >}}
specifically code that does this one thing.
{{< /alert-code >}}

Which looks like this:

Similarly, for additional content you can use:

{{< alert-content />}}

or

{{< alert-content >}}
Additional information about what specific content is needed
{{< /alert-content >}}

Which gets displayed like this:

Capitalization of titles

Our documentation uses Title Capitalization for linkTitle which should be short and Sentence capitalization for title which can be longer and more descriptive. For example, a linkTitle of Special Heading might have a title of The importance of a special heading in documentation

Line length

When editing the documentation’s source, which is written in plain HTML, limit your line lengths to around 100 characters.

Some of us take this one step further and use what is called semantic linefeeds, which is a technique whereby the HTML source lines, which are not read by the public, are split at ‘natural breaks’ in the prose. In other words, sentences are split at natural breaks between clauses. Instead of fussing with the lines of each paragraph so that they all end near the right margin, linefeeds can be added anywhere that there is a break between ideas.

This can make diffs very easy to read when collaborating through git, but it is not something we enforce contributors to use.

Translations

Selenium now has official translators for each of the supported languages.

• If you add a code example to the important_documentation.en.md file, also add it to important_documentation.ja.md, important_documentation.pt-br.md, important_documentation.zh-cn.md.
• If you make text changes in the English version, just make a Pull Request. The new process is for issues to be created and tagged as needs translation based on changes made in a given PR.

Code examples

All references to code should be language independent, and the code itself should be placed inside code tabs.

Default Code Tabs

The Docsy code tabs look like this:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    WebDriver driver = new ChromeDriver();
  

    driver = webdriver.Chrome()
  

    var driver = new ChromeDriver();
  

    driver = Selenium::WebDriver.for :chrome
  

    let driver = await new Builder().forBrowser('chrome').build();
  

    val driver = ChromeDriver()
  

To generate the above tabs, this is what you need to write. Note that the tabpane includes langEqualsHeader=true. This auto-formats the code in each tab to match the header name, but more importantly it ensures that all tabs on the page with a language are set to the same thing, so we always want to include it.

{{< tabpane langEqualsHeader=true >}}
  {{< tab header="Java" >}}
    WebDriver driver = new ChromeDriver();
  {{< /tab >}}
  {{< tab header="Python" >}}
    driver = webdriver.Chrome()
  {{< /tab >}}
  {{< tab header="CSharp" >}}
    var driver = new ChromeDriver();
  {{< /tab >}}
  {{< tab header="Ruby" >}}
    driver = Selenium::WebDriver.for :chrome
  {{< /tab >}}
  {{< tab header="JavaScript" >}}
    let driver = await new Builder().forBrowser('chrome').build();
  {{< /tab >}}
  {{< tab header="Kotlin" >}}
    val driver = ChromeDriver()
  {{< /tab >}}
{{< /tabpane >}}

Reference Github Examples

To ensure that all code is kept up to date, our goal is to write the code in the repo where it can be executed when Selenium versions are updated to ensure that everything is correct.

All code examples to be in our example directories.

This code can be automatically displayed in the documentation using the gh-codeblock shortcode. The shortcode automatically generates its own html, so if any tab is using this shortcode, set text=true in the tabpane/tab to prevent the auto-formatting, and add code=true in any tab that still needs to get formatted with code. Either way, set langEqualsHeader=true to keep the language tabs synchronized throughout the page. Note that the gh-codeblock line can not be indented at all.

One great thing about using gh-codeblock is that it adds a link to the full example. This means you don’t have to include any additional context code, just the line(s) that are needed, and the user can navigate to the repo to see how to use it.

A basic comparison of code looks like:

{{< tabpane text=true langEqualsHeader=true >}}
{{< tab header="Java" >}}
{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/getting_started/FirstScriptTest.java#L46-L47" >}}
{{< /tab >}}
{{< tab header="Python" >}}
{{< gh-codeblock path="examples/python/tests/getting_started/test_first_script.py#L17-L18" >}}
{{< /tab >}}
{{< tab header="CSharp" >}}
{{< gh-codeblock path="examples/dotnet/SeleniumDocs/GettingStarted/FirstScriptTest.cs#L39-L40" >}}
{{< /tab >}}
{{< tab header="Ruby" >}}
{{< gh-codeblock path="examples/ruby/spec/getting_started/first_script_spec.rb#L16-L17" >}}
{{< /tab >}}
{{< tab header="JavaScript" >}}
{{< gh-codeblock path="examples/javascript/test/getting_started/firstScript.spec.js#L23-L24" >}}
{{< /tab >}}
{{< tab header="Kotlin" >}}
{{< gh-codeblock path="examples/kotlin/src/test/kotlin/dev/selenium/getting_started/FirstScriptTest.kt#L39-L40" >}}
{{< /tab >}}
{{< /tabpane >}}

Which looks like this:

• Java
• Python
• CSharp
• Ruby
• JavaScript
• Kotlin

    text_box.send_keys("Selenium")

    text_box = driver.find_element(name: 'my-text')
    submit_button = driver.find_element(tag_name: 'button')

      let textBox = await driver.findElement(By.name('my-text'));
      let submitButton = await driver.findElement(By.css('button'));

        var textBox = driver.findElement(By.name("my-text"))
        val submitButton = driver.findElement(By.cssSelector("button"))

Using Markdown in a Tab

If you want your example to include something other than code (default) or html (from gh-codeblock), you need to first set text=true, then change the Hugo syntax for the tabto use % instead of < and > with curly braces:

{{< tabpane text=true langEqualsHeader=true >}}
{{% tab header="Java" %}}
1. Start the driver
{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/getting_started/FirstScriptTest.java#L17" >}}
2. Navigate to a page
{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/getting_started/FirstScriptTest.java#L18" >}}
3. Quit the driver
{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/getting_started/FirstScriptTest.java#L35" >}}
{{% /tab %}}
< ... >
{{< /tabpane >}}

This produces:

• Java

        WebDriver driver = new ChromeDriver();

        driver.get("https://www.selenium.dev/selenium/web/web-form.html");

        driver.quit();

This is preferred to writing code comments because those will not be translated. Only include the code that is needed for the documentation, and avoid over-explaining. Finally, remember not to indent plain text or it will rendered as a codeblock.