Weekly Newsletter

Summary

How to send out the weekly newsletter.

Details

Dendron sends out a weekly newsletter, scheduled for every Wednesday at 6AM PST.

Dendron uses Buttondown for managing a newsletter. It's a simple interface that uses Markdown formatting. To make our lives easier, we use a newsletter template and the Markdown Export Pod to send subscribers a copy of our weekly release notes.

Prerequisites

  • PodV2 Quickstart (Private)
    • We need to have the Markdown Export Pod configured so that we can copy the contents of the release notes to the clipboard with all URLs properly converted.

Steps

  • Open a new scratch note
  • Insert the weekly newsletter template: Newsletter
    • Follow the TODO items in the template
  • Run Export Pod V2 and export the content of the scratch note to clipboard
  • Login to Buttondown
    • Password should be available within the Dendron password vault. Reach out to the team if it isn't appearing, as you may need permissions.
  • Once logged in, you should be at a page for writing a new email. Paste what is in your clipboard into the body of the email.
  • If your clipboard copy included the note title as an H1 header, remove that header
  • Remove the Dendron {version} has sprouted text repeated under the first header
  • Remove the Changelog section
  • If the release notes have indented bullet points (in the contributor section, events section, etc.), make sure each indent is four spaces. This is because Buttondown doesn't seem to acknowledge when there is only two spaces used for indentation in lists. Use the email preview to confirm the formatting will be working as expected.
  • Review the note with the preview render showing in order to confirm that the email will be rendering the markdown correctly.
  • Confirm that the email includes no broken links (Buttondown will show a warning if it discovers any, and will show these below the email near the scheduling buttons).
  • Email title should in the following format:
    • Dendron Weekly: 0.86 release, Airtable Export pod enhancements, Dendron speed improvements, bug fixes, and more!
    • Modify for release version and specific highlights.
  • Schedule the email for Wednesday at 6AM PST.
    • Clicking on Sending Immediately is a way to schedule (it won't actually send immediately!).
    • Then click on Schedule for <total> subscribers to confirm a scheduled email.

Template


Backlinks