Design decision
The following are design decision for WET. Those decision are used for providing guidance on how to design content, features and theme. Design decision are subject for review by every wet-boew contributor and its official approval is made by participant of the WET-BOEW Roadmap monthly meeting, WET expert and WET administrator. Any propose changes to an approved design design, except to trivial editorial fixes, are subject to go through the whole approval process.
If you have any questions in regards of one of the above design decision, please open an issue in the wet-boew repository.
Current
- Design decision 1: Use SVG with img element instead of object (Pattern)
- Design decision 2: Browser supported (Support scope)
- Design decision 3: WET API/Blueprint
- Design decision 4: Basic HTML mode and progressive enhancement
- Design Decision 5: Decision on repository migration
- Design Decision 6: Versioning
- Design decision 8: Dual implementation of structured data with JSON-LD and RDFa Lite in a single web page
- Design decision 9: Release early, release often (STR)
- Design decision 10: Provisional feature
- Design decision 11: Resize text testing methodology
- Design decision 12: Double H1 on a single page
- Design decision 13: Reduce aggressiveness of form validation plugin
Presented
Proposed (Going to be presented)
- None
Ready
Design decision ready to be presented at the roadmap WET-BOEW meeting.
Draft
Design decision that required some additional testing or information before to be officially submited
- Avoid to use heading in summary element., todos:
- Write test case with and without an heading in summary
- Need AT testing
- Github related issue wet-boew/wet-boew#7314
Future design decision idea
- Web page meaningful sequence, focus order, consistent navigation conforming for a specific view port but not between view port.
- Long term release and doing more frequent releases (~weekly)
Obsolete
Process overview to obsolete a design decision. It can be obsoleted if they are not valid when considering the latest common and best practice. In order to obsolete a decision, an evidence would need to be documented and presented explaining why it is not valid accompanied with recommendation of a process to migrate content that was following the obsoleted design decision. You can initiate the conversation by submitting a new issue on Github in the wet-boew main repository.
Approval process
The approval process consist in the following steps:
- A wet-boew contributor publish a draft of a design decision document.
- The design decision draft is presented at one of the monthly WET-BOEW Roadmap meeting.
- Sponsorship by a WET expert could required.
- The author must address all comments, do the research and clarify the design decision documents as needed.
- The document is presented again at a subsequent WET-BOEW Roadmap meeting.
- Upon satisfaction of the WET-BOEW Roadmap meeting participant, WET expert and WET administration, the document get it’s approval
- The Design Decision is then published and considered as a new best practice by the wet-boew community.