You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@struts.apache.org by lu...@apache.org on 2017/10/03 18:26:04 UTC
[struts-site] branch master updated: Converts page to MD
This is an automated email from the ASF dual-hosted git repository.
lukaszlenart pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/struts-site.git
The following commit(s) were added to refs/heads/master by this push:
new a62b89d Converts page to MD
a62b89d is described below
commit a62b89dcc1f4111917363745520d9e7692d6ea81
Author: Lukasz Lenart <lu...@apache.org>
AuthorDate: Tue Oct 3 20:25:53 2017 +0200
Converts page to MD
---
source/mail.html | 208 -------------------------------------------------------
source/mail.md | 110 +++++++++++++++++++++++++++++
2 files changed, 110 insertions(+), 208 deletions(-)
diff --git a/source/mail.html b/source/mail.html
deleted file mode 100644
index 8607ef1..0000000
--- a/source/mail.html
+++ /dev/null
@@ -1,208 +0,0 @@
----
-layout: default
-title: Mailing Lists
----
-
-<h1>Mailing Lists</h1>
-<p>
- A mailing list is an electronic discussion forum that anyone
- can subscribe to. When someone sends an email message to the
- mailing list, a copy of that message is broadcast to everyone who is
- subscribed to that mailing list. Mailing lists are the primary means of
- communication for people working within the Apache Struts Project.
-</p>
-
-<p class="alert alert-block alert-error">
- <strong>HEADS UP!</strong><br/>
-
- A message sent to a public mailing list
- cannot be unpublished. Although we might be able to modify our own
- mail archives, the message is mirrored to a lot of other archiving
- systems which we do not have under control. Therefore
- almost 100% of all delete requests are denied. Please make
- sure you <strong>do not send any potential sensitive information to the mailing list</strong>,
- including passwords, server names, ips and so on.
-</p>
-
-<h2>Subscribing</h2>
-
-<table class="table table-striped table-condensed">
- <tr>
- <th>Name</th>
- <th>Subscribe</th>
- <th>Unsubscribe</th>
- <th>Description</th>
- </tr>
-
- <tr>
- <td><a href="https://lists.apache.org/list.html?announcements@struts.apache.org">Struts-Announcements</a></td>
- <td><a href="mailto:announcements-subscribe@struts.apache.org?subject=subscribe&body=subscribe">announcements-subscribe@struts.apache.org</a></td>
- <td><a href="mailto:announcements-unsubscribe@struts.apache.org?subject=unsubscribe&body=unsubscribe">announcements-unsubscribe@struts.apache.org</a></td>
- <td>Major Announcements, low-volume, read only</td>
- </tr>
-
- <tr>
- <td><a href="https://lists.apache.org/list.html?user@struts.apache.org">Struts-User</a></td>
- <td><a href="mailto:user-subscribe@struts.apache.org?subject=subscribe&body=subscribe">user-subscribe@struts.apache.org</a></td>
- <td><a href="mailto:user-unsubscribe@struts.apache.org?subject=unsubscribe&body=unsubscribe">user-unsubscribe@struts.apache.org</a></td>
- <td>Contact to other Struts-users and ask questions on installation or features</td>
- </tr>
-
- <tr>
- <td>Users Digest</td>
- <td><a href="mailto:user-digest-subscribe@struts.apache.org?subject=subscribe&body=subscribe">user-digest-subscribe@struts.apache.org</a></td>
- <td><a href="mailto:user-digest-unsubscribe@struts.apache.org?subject=unsubscribe&body=unsubscribe">user-digest-unsubscribe@struts.apache.org</a></td>
- <td>Get a daily digest of the Struts Users list</td>
- </tr>
-</table>
-
-<p class="alert alert-success">
- You can use a web interface as well if you want to post a question <a href="https://lists.apache.org/list.html?user@struts.apache.org">https://lists.apache.org/</a>
-</p>
-
-<a class="anchor" name="archives"></a>
-
-<p>
- You can read the <a href="http://mail-archives.apache.org/mod_mbox/struts-user/">ASF Mail</a>
- or the <a href="http://markmail.org/list/org.apache.struts.users/">Mark Mail</a> Archives if you
- are looking for older discussions. There are many other archives out there as well.
-</p>
-
-<p class="alert alert-success">
- If you want to <strong>discuss patches or contribute to Struts</strong> you should
- subscribe to the <a href="dev-mail.html">developers list</a>.
-</p>
-
-<h2>Guidelines</h2>
-<p>
- Mailing lists provide a simple and effective communication
- mechanism. With potentially thousands of subscribers, there is a
- common set of etiquette guidelines that you should observe. Please keep
- on reading.
-</p>
-
-<p class="alert alert-box alert-error">
- <strong>
- Join the lists that are appropriate for your
- discussion.
- </strong>
- <br/>
- Please make sure that you are joining the list that is
- appropriate for the topic or product that you would like to discuss. For
- example, please do not join the Struts mailing list and ask
- questions about Tomcat. Instead, you should join the Tomcat User list and ask your
- questions there.
-</p>
-
-<h3><a class="anchor" name="respect"></a>Respect the mailing list type.</h3>
-
-<p>
- The "User" list is where you can send questions and comments about
- configuration, setup, usage and other "user" types of questions.
- The focus of the user list should be one "how" to do
- something with the framework we have today.
- The focus of the dev list is how we want to do something
- with a future version of the framework.
-</p>
-
-<p>
- The "Developer" (or "Dev") list is where you can send questions and
- comments about the actual software source code and general
- "development" types of questions. Questions about the "future" of Struts are
- best addressed to the dev list.
-</p>
-
-<p>
- Some questions may seem appropriate for posting on both the
- "user" and the "developer" lists. In this case, pick one and only one.
- Do not cross post, unless a Committer asks that the
- thread be moved to the other list.
-</p>
-
-<h3><a class="anchor" name="post"></a>Do not cross post messages.</h3>
-
-<p>
- In other words, pick a mailing list and send your messages
- to that mailing list only. Do not send your messages to multiple mailing
- lists. The reason is that people may be subscribed to one list and not to the
- other. Therefore, some people will only see part of the conversation.
-</p>
-
-<h3><a class="anchor" name="reply-to"></a>Watch where you are sending email.</h3>
-
-<p>
- The majority of our mailing lists have set the Reply-To to
- go back to the list. That means that when you Reply to a message, it will
- go to the list and not to the original author directly. The reason is
- because it helps facilitate discussion on the list for everyone to benefit
- from. Be careful of this as sometimes you may intend to reply to a message
- directly to someone instead of the entire list.
-</p>
-
-<h3><a class="anchor" name="plain"></a>Do not send HTMLÂ emails to the list.</h3>
-
-<p>
- If you are using Outlook or Outlook Express or Eudora,
- chances are that you are sending HTML email by default. There is usually a
- setting that will allow you to send "Plain Text" email.
-</p>
-
-<h3><a class="anchor" name="short"></a>Keep your email short and to the point.</h3>
-
-<p>
- If your email is more than about a page of text, chances
- are that it won't get read by very many people. It is much better to
- try to pack a lot of informative information (see above about asking
- smart questions) into as small of an email as possible. If you are replying
- to a previous email, it is a good idea to only quote the parts that you
- are replying to and to remove the unnecessary bits. This makes it
- easier for people to follow a thread as well as making the email archives
- easier to search and read.
-</p>
-
-
-<h3><a class="anchor" name="trolls"></a>Don't feed the trolls.</h3>
-
-<blockquote>
- <p>
- "In Internet terminology, a troll is a person who posts rude or offensive messages on the
- Internet, such as in online discussion forums, to disrupt discussion or to upset its
- participants (see Anonymous Internet posting). "Troll" can also mean the message itself or be a
- verb meaning to post such messages. "Trolling" is also commonly used to describe the activity."
- </p>
-
- <p>
- For more, see
- <a href="http://en.wikipedia.org/wiki/Internet_trolls">Internet Trolls</a>
- in the Wikipedia.
- </p>
-</blockquote>
-
-<p>
- If someone makes an off-topic post that offends you,
- our best advice is to filter posts from that person to the trash.
- When subscribers do choose to respond, sometimes a thread
- will feed on itself, and grow out of control.
- When that happens, our best advice is to filter the entire thread to the trash.
-</p>
-
-<p>
- Our spam filters will catch most types of commercial spam,
- but troll spam is a hard for software to spot.
- The best defense is to withhold from the troll what he or she wants most: A response.
-</p>
-
-<h3><a class="anchor" name="smart"></a>Ask smart questions.</h3>
-
-<p>
- Every volunteer project obtains its strength from the
- people involved in it. You are welcome to join any of our mailing lists.
- You can choose to lurk, or actively participate; it's up to you.
- The level of community responsiveness to specific questions is
- generally directly proportional to the amount of effort you spend formulating
- your question. Eric Raymond and Rick Moen have even written an
- essay entitled
- <a href="http://www.catb.org/~esr/faqs/smart-questions.html">"Asking Smart Questions"</a>
- precisely on this topic. Please read the essay, follow its advice,
- and then post your smart questions to the appropriate list.
-</p>
diff --git a/source/mail.md b/source/mail.md
new file mode 100644
index 0000000..9f7fab3
--- /dev/null
+++ b/source/mail.md
@@ -0,0 +1,110 @@
+---
+layout: default
+title: Mailing Lists
+---
+
+# Mailing Lists
+A mailing list is an electronic discussion forum that anyone can subscribe to. When someone sends an email message
+to the mailing list, a copy of that message is broadcast to everyone who is subscribed to that mailing list. Mailing
+lists are the primary means ofcommunication for people working within the Apache Struts Project.
+
+**HEADS UP!**
+
+A message sent to a public mailing list cannot be unpublished. Although we might be able to modify our own mail archives,
+the message is mirrored to a lot of other archiving systems which we do not have under control. Therefore almost 100%
+of all delete requests are denied. Please make sure you **do not send any potential sensitive information to the mailing list<**,
+including passwords, server names, ips and so on.
+{:.alert .alert-block .alert-error}
+
+## Subscribing
+
+|Name|Subscribe|Unsubscribe|Description|
+|----|---------|-----------|-----------|
+|[Struts-Announcements](https://lists.apache.org/list.html?announcements@struts.apache.org)|[announcements-subscribe@struts.apache.org](mailto:announcements-subscribe@struts.apache.org?subject=subscribe&body=subscribe)|[announcements-unsubscribe@struts.apache.org](mailto:announcements-unsubscribe@struts.apache.org?subject=unsubscribe&body=unsubscribe)|Major Announcements, low-volume, read only|
+|[Struts-User](https://lists.apache.org/list.html?user@struts.apache.org)|[user-subscribe@struts.apache.org](mailto:user-subscribe@struts.apache.org?subject=subscribe&body=subscribe)|[user-unsubscribe@struts.apache.org](mailto:user-unsubscribe@struts.apache.org?subject=unsubscribe&body=unsubscribe)|Contact to other Struts-users and ask questions on installation or features|
+|Users Digest|[user-digest-subscribe@struts.apache.org](mailto:user-digest-subscribe@struts.apache.org?subject=subscribe&body=subscribe)|[user-digest-unsubscribe@struts.apache.org](mailto:user-digest-unsubscribe@struts.apache.org?subject=unsubscribe&body=unsubscribe)|Get a daily digest of the Struts Users list|
+
+You can use a web interface as well if you want to post a question [https://lists.apache.org/](https://lists.apache.org/list.html?user@struts.apache.org)
+{:.alert .alert-success}
+
+You can read the [ASF Mail](http://mail-archives.apache.org/mod_mbox/struts-user) or the [Mark Mail](http://markmail.org/list/org.apache.struts.users)
+Archives if you are looking for older discussions. There are many other archives out there as well.
+{:.anchor name=archives}
+
+
+If you want to **discuss patches or contribute to Struts** you should subscribe to the [developers list](dev-mail.html).
+{:.alert .alert-success}
+
+## Guidelines
+
+Mailing lists provide a simple and effective communication mechanism. With potentially thousands of subscribers, there
+is a common set of etiquette guidelines that you should observe. Please keep on reading.
+
+**Join the lists that are appropriate for your discussion.**
+
+Please make sure that you are joining the list that is appropriate for the topic or product that you would like to discuss.
+For example, please do not join the Struts mailing list and ask questions about Tomcat. Instead, you should join the Tomcat
+User list and ask your questions there.
+{:.alert .alert-box .alert-error}
+
+### Respect the mailing list type
+
+The "User" list is where you can send questions and comments about configuration, setup, usage and other "user"
+types of questions. The focus of the user list should be one "how" to do something with the framework we have today.
+The focus of the dev list is how we want to do something with a future version of the framework.
+
+The "Developer" (or "Dev") list is where you can send questions and comments about the actual software source code
+and general "development" types of questions. Questions about the "future" of Struts are best addressed to the dev list.
+
+Some questions may seem appropriate for posting on both the "user" and the "developer" lists. In this case, pick one
+and only one. Do not cross post, unless a Committer asks that the thread be moved to the other list.
+
+### Do not cross post messages.
+
+In other words, pick a mailing list and send your messages to that mailing list only. Do not send your messages to multiple
+mailing lists. The reason is that people may be subscribed to one list and not to the other. Therefore, some people will
+only see part of the conversation.
+
+### Watch where you are sending email.
+
+The majority of our mailing lists have set the Reply-To to go back to the list. That means that when you Reply to a message,
+it will go to the list and not to the original author directly. The reason is because it helps facilitate discussion
+on the list for everyone to benefit from. Be careful of this as sometimes you may intend to reply to a message directly
+to someone instead of the entire list.
+
+### Do not send HTMLÂ emails to the list.
+
+If you are using Outlook or Outlook Express or Eudora, chances are that you are sending HTML email by default. There is
+usually a setting that will allow you to send "Plain Text" email.
+
+### Keep your email short and to the point.
+
+If your email is more than about a page of text, chances are that it won't get read by very many people. It is much better
+to try to pack a lot of informative information (see above about asking smart questions) into as small of an email as possible.
+If you are replying to a previous email, it is a good idea to only quote the parts that you are replying to and to remove
+the unnecessary bits. This makes it easier for people to follow a thread as well as making the email archives easier
+to search and read.
+
+### Don't feed the trolls.
+
+> "In Internet terminology, a troll is a person who posts rude or offensive messages on the Internet, such as in online
+> discussion forums, to disrupt discussion or to upset its participants (see Anonymous Internet posting). "Troll" can
+> also mean the message itself or be a verb meaning to post such messages. "Trolling" is also commonly used to describe
+> the activity."
+>
+> For more, see [Internet Trolls](http://en.wikipedia.org/wiki/Internet_trolls) in the Wikipedia.
+
+If someone makes an off-topic post that offends you, our best advice is to filter posts from that person to the trash.
+When subscribers do choose to respond, sometimes a thread will feed on itself, and grow out of control. When that happens,
+our best advice is to filter the entire thread to the trash.
+
+Our spam filters will catch most types of commercial spam, but troll spam is a hard for software to spot. The best defense
+is to withhold from the troll what he or she wants most: A response.
+
+### Ask smart questions.
+
+Every volunteer project obtains its strength from the people involved in it. You are welcome to join any of our mailing
+lists. You can choose to lurk, or actively participate; it's up to you. The level of community responsiveness to specific
+questions is generally directly proportional to the amount of effort you spend formulating your question. Eric Raymond
+and Rick Moen have even written an essay entitled [Asking Smart Questions](http://www.catb.org/~esr/faqs/smart-questions.html)
+precisely on this topic. Please read the essay, follow its advice, and then post your smart questions to the appropriate list.
--
To stop receiving notification emails like this one, please contact
['"commits@struts.apache.org" <co...@struts.apache.org>'].