| .. Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| |
| ***** |
| Email |
| ***** |
| |
| |
| Email routing |
| ------------- |
| |
| routing mechanism will be a dotted path from the project to |
| the application/tool to the specific artifact within that app that is |
| used like this:: |
| |
| subproject.app.artifact@project.example.com |
| |
| Which would translate into the devtools project which is a subproject of |
| turbogears, and it's bug tracker and ticket 142 in that tracker:: |
| |
| devtools.bug.142@turbogears.sf.net |
| |
| |
| And it in turn would be published to the message bus, which will assure |
| that all tools that are registered to be notified for that e-mail |
| addresses are called like that. |
| |
| If your app has more than one artifact type, you could nest them inside |
| `project.app.something.id.*` |
| |
| If you were working with the bug tracker directly on the TurboGears project:: |
| |
| bug.142@turbogears.sf.net |
| |
| |
| Email Content Handling |
| ---------------------- |
| |
| On Allura message bodies should be composed as markdown. |
| Multi-part mime encoded messages should be sent include plain text |
| (the markdown) and html (rendered from the markdown). |
| |
| Users are allowed to register that they want plain text only. |
| |
| We will also include some text in the footer of the e-mail message with a |
| link to the message online. We can use this link to guess where in the |
| thread the message belongs in the case of a messed up e-mail client that |
| does not set the headers for the reply properly. |
| |
| The nice thing about this is that it's pretty much already implemented |
| for us via the meta tool. |
| |
| This metadata syntax will let you set fields on tickets and otherwise |
| interact with the system via e-mail, assuming you have such permissions. |