zulip/docs
Daniil Fadeev 2f203f4de1 emails: Inline CSS in emails in build_email.
Previously, we had an architecture where CSS inlining for emails was
done at provision time in inline_email_css.py. This was necessary
because the library we were using for this, Premailer, was extremely
slow, and doing the inlining for every outgoing email would have been
prohibitively expensive.

Now that we've migrated to a more modern library that inlines the
small amount of CSS we have into emails nearly instantly, we are able
to remove the complex architecture built to work around Premailer
being slow and just do the CSS inlining as the final step in sending
each individual email.

This has several significant benefits:

* Removes a fiddly provisioning step that made the edit/refresh cycle
  for modifying email templates confusing; there's no longer a CSS
  inlining step that, if you forget to do it, results in your testing a
  stale variant of the email templates.
* Fixes internationalization problems related to translators working
  with pre-CSS-inlined emails, and then Django trying to apply the
  translators to the post-CSS-inlined version.
* Makes the send_custom_email pipeline simpler and easier to improve.

Signed-off-by: Daniil Fadeev <fadeevd@zulip.com>
2023-04-05 12:22:29 -07:00
..
_static docs: Move homepage link to TOC tree. 2023-03-03 23:06:17 -08:00
_templates docs: Add SCIM page to list of new production/ pages. 2023-04-03 17:06:05 -07:00
contributing docs: Document preference for hyphenated class and ID values. 2023-03-27 17:31:31 -07:00
development dependencies: Switch to pnpm. 2023-03-20 15:48:29 -07:00
documentation web: Save a needless 301 redirect from /integrations to /integrations/. 2023-03-24 14:51:01 -07:00
git dependencies: Switch to pnpm. 2023-03-20 15:48:29 -07:00
images docs: Update documentation for tips when writing pull request comments. 2023-03-07 15:40:04 -08:00
outreach web: Save a needless 301 redirect from /team to /team/. 2023-03-24 14:51:01 -07:00
overview docs: Update changelog to cover changes already staged for 7.0. 2023-04-02 23:28:10 -07:00
production docs: Always suggest start-server, now that it is safer. 2023-04-04 10:58:56 -07:00
subsystems emails: Inline CSS in emails in build_email. 2023-04-05 12:22:29 -07:00
testing run-dev: Drop .py from script name. 2023-03-03 18:02:37 -08:00
translating web: Save a 301 redirect from /help to /help/. 2023-03-24 14:51:01 -07:00
tutorials run-dev: Drop .py from script name. 2023-03-03 18:02:37 -08:00
.gitignore
Makefile Revert "docs: Temporarily disable parallel building." 2022-02-28 16:28:31 -08:00
README.md docs: Capitalize Markdown consistently. 2020-08-11 10:23:06 -07:00
THIRDPARTY navbar: Use feathericon close icon. 2023-03-24 16:30:15 -07:00
code-of-conduct.md
conf.py docs: Convert .html#fragment links to .md#fragment. 2022-02-28 16:28:31 -08:00
index.md web: Save a 301 redirect from /help to /help/. 2023-03-24 14:51:01 -07:00

README.md

Zulip Markdown documentation hosted elsewhere

The Markdown files in this directory ( /zulip/docs ) are not intended to be read on GitHub. Instead, visit our ReadTheDocs to read the Zulip documentation.