rails/actionmailbox
Petrik 8565f45100 Use relative includes of README's in documentation [ci-skip]
The Rails documentation uses the `:include:` directive to inline the
README of the framework into the main documentation page. As the
README's aren't in the root directory from where SDoc is run we need to
add the framework path to the include:

    # :include: activesupport/README.md

This results in a warning when installing the gems as generating the rdoc for the gem is run from the gem/framework root:

    Couldn't find file to include 'activesupport/README.rdoc' from lib/active_support.rb

The `:include:` RDoc directive supports includes relative to the current
file as well:

    # :include: ../README.md

This makes sure it works for the Rails API docs and the separate gems.

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>
2024-01-18 10:39:15 +01:00
..
app Prepend `$` to example CLI commands [ci-skip] 2024-01-07 17:27:23 -06:00
bin Import Action Mailbox 2018-12-25 21:32:35 -05:00
config Remove 4 unroutable routes from ActionMailbox 2022-05-31 15:38:45 -05:00
db/migrate feat: use config pk type in Action Mailbox migration 2023-05-04 08:19:36 -07:00
lib Use relative includes of README's in documentation [ci-skip] 2024-01-18 10:39:15 +01:00
test Do not generate pidfile in production environments (#50644) 2024-01-08 14:47:25 -05:00
.gitignore Ignore local .sqlite3 files that are created under storage directory 2022-12-27 11:35:26 +09:00
CHANGELOG.md Take AR affixes into account for Action Mailbox database models 2023-12-09 11:02:30 +01:00
MIT-LICENSE Remove Copyright years (#47467) 2023-02-23 11:38:16 +01:00
README.md 🔗 Remove RDoc auto-link from Rails module everywhere 2023-06-23 10:49:30 +09:00
Rakefile Add `rake test:isolated` for Action Mailbox 2023-01-16 14:38:17 +09:00
actionmailbox.gemspec Remove workaround for `mail` gem dependencies 2024-01-09 13:25:36 +01:00

README.md

Action Mailbox

Action Mailbox routes incoming emails to controller-like mailboxes for processing in \Rails. It ships with ingresses for Mailgun, Mandrill, Postmark, and SendGrid. You can also handle inbound mails directly via the built-in Exim, Postfix, and Qmail ingresses.

The inbound emails are turned into InboundEmail records using Active Record and feature lifecycle tracking, storage of the original email on cloud storage via Active Storage, and responsible data handling with on-by-default incineration.

These inbound emails are routed asynchronously using Active Job to one or several dedicated mailboxes, which are capable of interacting directly with the rest of your domain model.

You can read more about Action Mailbox in the Action Mailbox Basics guide.

License

Action Mailbox is released under the MIT License.