diff --git a/docs/dev/code/entity.md b/docs/dev/code/entity.md
index 1449517..4c497d9 100644
--- a/docs/dev/code/entity.md
+++ b/docs/dev/code/entity.md
@@ -78,4 +78,4 @@
 
 * **[Entity Design Tips]({{site.url}}/dev/tips/index.html#EntityDesign)**
 * The **[User Guide]({{site.url}}/use/guide/index.html)**
-* The **[Mailing List](http://groups.google.com/group/brooklyn-dev)** (brooklyn-dev@googlegroups.com)
+* The **[Mailing List](https://mail-archives.apache.org/mod_mbox/incubator-brooklyn-dev/)**
diff --git a/docs/dev/code/index.include.md b/docs/dev/code/index.include.md
index e36adb1..84b8a3d 100644
--- a/docs/dev/code/index.include.md
+++ b/docs/dev/code/index.include.md
@@ -79,5 +79,5 @@
   and [entities]({{ site.url }}/use/guide/entities/index.html)
 
 Where things aren't documented **please ask us** at 
-[brooklyn-dev@googlegroups.com](http://groups.google.com/group/brooklyn-dev)
+[the brooklyn mailing list](https://mail-archives.apache.org/mod_mbox/incubator-brooklyn-dev/)
 so we can remedy this!
diff --git a/docs/dev/how-to-contrib.md b/docs/dev/how-to-contrib.md
index 288a92e..bef605c 100644
--- a/docs/dev/how-to-contrib.md
+++ b/docs/dev/how-to-contrib.md
@@ -10,7 +10,7 @@
 whether a new supported entity, or a policy, or an example --
 it's easy to give back to the community.  Just:
 
-1. **Tell [brooklyn-dev@googlegroups.com](http://groups.google.com/group/brooklyn-dev)** about your work or interest
+1. **Tell [the brooklyn mailing list](https://mail-archives.apache.org/mod_mbox/incubator-brooklyn-dev/)** about your work or interest
 
 1. **Create your fork** of the project on GitHub
 
diff --git a/docs/meta/contact.include.md b/docs/meta/contact.include.md
index e9be808..e0d1e4b 100644
--- a/docs/meta/contact.include.md
+++ b/docs/meta/contact.include.md
@@ -1,12 +1,9 @@
 
-Contact us on the discussion groups:
-
-* **[brooklyn-users@googlegroups.com](http://groups.google.com/group/brooklyn-users)**: discussions about _using_ Brooklyn
-* **[brooklyn-dev@googlegroups.com](http://groups.google.com/group/brooklyn-dev)**: discussions about _development_ in Brooklyn 
+Contact us on the [brooklyn mailing list](https://mail-archives.apache.org/mod_mbox/incubator-brooklyn-dev/).
 
 Additionally look for us on:
 
 * **IRC**: #brooklyncentral ([IRC??](/meta/irc.html))
 * **Twitter**: @brooklyncentral #brooklyncentral
 
-We'd love to hear from you!
\ No newline at end of file
+We'd love to hear from you!
diff --git a/docs/meta/governance.md b/docs/meta/governance.md
index 3c8d0e7..16bda51 100644
--- a/docs/meta/governance.md
+++ b/docs/meta/governance.md
@@ -11,7 +11,7 @@
 Most decisions about the project -- 
 agreeing approaches, accepting contributions, and resolving problems --
 are generally by consensus on the
-[brooklyn-dev@](http://groups.google.com/group/brooklyn-dev) 
+[brooklyn dev](https://mail-archives.apache.org/mod_mbox/incubator-brooklyn-dev/) 
 mailing list,
 in which **all mailing list members** may participate.
 However, only **committers** are permitted to make changes to
@@ -38,7 +38,7 @@
 
 The voting rules are as follows:
 
-* Votes are called by email to [brooklyn-dev@googlegroups.com](http://groups.google.com/group/brooklyn-dev)
+* Votes are called by email to [the brooklyn dev mailing list](https://mail-archives.apache.org/mod_mbox/incubator-brooklyn-dev/)
 * Votes should come by email 
 * Comments are welcome from all members, and committers should take these into consideration
 * A simple majority of those committers who respond within 24h is required
diff --git a/docs/meta/irc.md b/docs/meta/irc.md
index 41e5d6a..28b0179 100644
--- a/docs/meta/irc.md
+++ b/docs/meta/irc.md
@@ -15,8 +15,8 @@
 patient if you don't get an instant answer - unless there's already a conversation 
 happening folk will probably not have their eyes on the channel.) 
 
-You may want to do other things while you wait, like reviewing the [brooklyn-users](https://groups.google.com/forum/#!forum/brooklyn-users) and 
-[brooklyn-dev](https://groups.google.com/forum/#!forum/brooklyn-dev) lists to see if anyone has had the same issue before.
+You may want to do other things while you wait, like reviewing the [brooklyn mailing list](https://mail-archives.apache.org/mod_mbox/incubator-brooklyn-dev/)
+lists to see if anyone has had the same issue before.
 
 ## Brooklyn IRC Channel
 
diff --git a/docs/start/release-notes.md b/docs/start/release-notes.md
index 9fb55ce..adf79d5 100644
--- a/docs/start/release-notes.md
+++ b/docs/start/release-notes.md
@@ -20,10 +20,8 @@
 
 Thanks also go to Brooklyn's commercial users. Already Brooklyn has been adopted into some very exciting projects including 
 
-For more information, please checkout [brooklyncentral.github.io](http://brooklyncentral.github.io), and the mailing lists:
- 
-* [brooklyn-dev@googlegroups.com](http://groups.google.com/group/brooklyn-dev)
-* [brooklyn-users@googlegroups.com](http://groups.google.com/group/brooklyn-users)
+For more information, please checkout [brooklyncentral.github.io](http://brooklyncentral.github.io), and our
+[mailing list at Apache](https://mail-archives.apache.org/mod_mbox/incubator-brooklyn-dev/).
 
 ### New Features