Add note

2024-02-08 13:29:08 -06:00
parent 4edbcd2b94
commit fe20b4d575
1 changed files with 16 additions and 0 deletions
@@ -0,0 +1,16 @@
 # Global Dialogs
 The dialogs and utils contained in this directory are intended to be "global" in
 the sense that they are very common.
 A good example: the report dialog. We need to be able to open one from every
 post, but if every post had its own `Dialog`, performance would suffer.
 Previously the solution was to use the same modal/sheet via `Modal`, and just
 swap out the content.
 The solution here is to only render the dialog when it's opened, and to enable
 programmatic opening of said dialog e.g. from a context menu.
 **For other dialogs that can be rendered _in situ_, use `Dialog` directly.**
 Only use this abstraction for instances that either aren't possible or would be
 performance intensive when defining a `Dialog` in situ.