Experimentelle APIs
Einige der APIs von Electron sind in der Dokumentation mit _Experimental_ gekennzeichnet. Dieses Tag weist darauf hin, dass die API zu den Unstabilen zählt und somit häufiger einmal entfernt oder geändert wird, als andere APIs mit weniger Warnungen.
Voraussetzungen für die Markierung einer API als Experimentell
Jeder kann beantragen, dass eine API in einer Feature-PR als experimentell markiert wird, Meinungsverschiedenheiten über den experimentellen Charakter eines Features können in der API-AG diskutiert werden, wenn sie nicht in der PR gelöst werden können.
Verfahren zum Entfernen des Experimental-Tags
Sobald eine API in mindestens zwei wichtigen stabilen Release-Linien stabil war, kann sie nominiert werden, um ihr experimentelles Tag zu entfernen. Diese Diskussion sollte in einem API-AG-Meeting stattfinden. Dinge, die bei der Diskussion/Nominierung zu berücksichtigen sind:
- Die oben angeführte Vorraussetzung "zwei stabile Release-Hauptlinien muss erfüllt sein
- Während dieser Zeit dürfen durch die Einführung dieser Funktionalität keine größeren Bugs/Probleme verursacht worden sein
- Die API ist stabil genug und wurde nicht sonderlich stark von Chromium-Upgrades beeinträchtigt
- Verwendet irgendjemand die API?
- Erfüllt die API die ursprünglich vorgeschlagenen Anwendungsfälle, weist sie Lücken auf?