Skip to content

Latest commit

 

History

History
27 lines (21 loc) · 2.38 KB

custom-events.md

File metadata and controls

27 lines (21 loc) · 2.38 KB

Custom Events

Eiffel offers a rich vocabulary designed to cover the vast majority of continuous integration and delivery use cases. Situations may arise where the defined events are not sufficient, however. In such circumstances, users are encouraged to spawn a discussion by creating an Issue in the Eiffel repository - perhaps the existing vocabulary can be used, or perhaps the new use case warrants changes to the Eiffel event definitions.

That being said, users are free to send custom complementary events in parallel with Eiffel events. These events can be defined similarly to the standard vocabulary and may use links to reference the standard Eiffel events. When defining such custom events, however, there are a few rules of conduct that users are strongly encouraged to observe:

  • Custom events are not allowed masquerade as standard Eiffel events, and shall therefore not be prefixed "Eiffel". To exemplify, a recommended custom event name would be "MyCustomEvent", but not "EiffelMyCustomEvent".
  • Use Issues and Pull requests to stay in touch with the community to discuss why and how you define custom events. Others may find them useful, too!
  • Follow the event design guidelines.
  • Consider whether your need can be addressed by data.customData.
  • Users defining custom events are responsible for them and any compatibility issues. Special considerations or support from standard Eiffel events can not be expected, unless the custom events are proposed to and accepted into the standard Eiffel vocabulary (and consequently are no longer custom).