view which can be accessed via the "Preferences" option in the header bar user
dropdown:
-TODO - Image of notifications preferences with preferences option
+
Within here are three new user preferences:
that may work in addition to, or override, your global notification preferences.
You can watch any book, chapter or page via the new "Watch" action:
-TODO - Image of watch action.
+
By default this will watch for both new pages and page changes. This can be changed
via the watch options menu, found by selecting the watch status in the details:
-TODO - Image of watch menu
+<img width="420" src="/images/2023/08/watch_options.png" alt='A view within the details for a page in BookStack, showing various options for watching the page, including "Ignore", "All Page Updates" and "All Page Updates & Comments"'>
This provides various different levels of watching of content, in addition to the ability
to ignore any notification events if things are getting too noisy within a particular book,
When a page or chapter has active watch preferences from a parent item, this will be reflected
in the details of that item:
-TODO - Image of parent watch
+
Notifications are sent upon relevant activity, and will include a few details
in addition to a link to the relevant content:
-TODO - Image of notification
+
Page update notifications are somewhat debounced, meaning that the system will avoid
sending notifications if re-updated by the same author within a time window. This is
For a stable upgrade path, this permission will only be provided to the default
"Admin" user role upon upgrade, so you'll need to assign it to other roles where desired:
-TODO - Image of notifications permission
+
An important consideration of this system is performance. Having to send out emails
upon certain common actions does require extra time, making these actions slow.
the browser version will be cleared. If the save process fails, the browser stored image will
remain and you'll get a prompt when you next try to edit/create a drawing:
-TODO - Image of prompt
+
You can confirm via this prompt to then restore the browser-saved image into diagrams.net
for continued editing and re-attempt of saving.