Skip to main content

max / makenotwork

1.1 KB · 26 lines History Blame Raw
1 //! Widgets: named assemblies of things the description already says.
2 //!
3 //! The third tier, between a primitive and `Region::Bespoke`. A primitive is
4 //! drawn from scratch by every renderer and has to be something every host can
5 //! honour; a bespoke region is one app's own and carries no contents the
6 //! description knows. A widget is neither: a *name* over an assembly of members
7 //! the vocabulary already has.
8 //!
9 //! Full argument: wiki `widget-tier`.
10 //!
11 //! # What is left here
12 //!
13 //! Glue, and only glue. The widgets themselves live in `quasi-basics`, which is
14 //! where the carousel went once it had been proved against three real pages.
15 //! Each module here is an Askama entry point: it turns whatever the templates
16 //! happened to need into the widget's own types, renders the fragment, and
17 //! stops.
18 //!
19 //! A widget that has never rendered anything is a guess about what the assembly
20 //! needs, so a new one is welcome to start here and leave later. The carousel
21 //! found a missing primitive on its way through
22 //! (`makeover_layout::Image`, 0.21.0), which is the argument for proving one in
23 //! an app before it becomes shared.
24
25 pub mod carousel;
26