grim/www.imfreedom.org

Parents 2bf415b9ae45
Children 5c426b25b6f9
Move the mailing list page to a contact page and add a page on how to connect to the xmpp service

Testing Done:
Ran locally

Reviewed at https://reviews.imfreedom.org/r/778/
--- a/hugo/config.toml Tue Jun 15 13:14:56 2021 -0500
+++ b/hugo/config.toml Tue Jun 22 19:35:31 2021 -0500
@@ -31,8 +31,8 @@
weight = 30
[[menu.main]]
- name = "Mailing Lists"
- url = "/mailing"
+ name = "Contact"
+ url = "/contact"
weight = 40
[[menu.main]]
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/hugo/content/contact.md Tue Jun 22 19:35:31 2021 -0500
@@ -0,0 +1,44 @@
+---
+title: "Contact"
+date: 2018-05-03
+aliases:
+ - mailing
+---
+
+## XMPP
+
+We run a federated XMPP instance on imfreedom.org, which means anyone with an
+XMPP account can join our conferences on conference.imfreedom.org. If you do not
+have an XMPP account, you can get a free
+[pidginchat.com](https://pidgin.im/about/pidginchat/) account which is able to
+join our conferences. For board members, please use your imfreedom.org accounts.
+More information about them can be found [here]({{< ref "xmpp" >}}).
+
+The following list describes the conferences we have on
+conferences.imfreedom.org.
+
+ * **board**: The board room, where discussions between the board happens.
+ * **discussion**: General discussion for Instant Messaging Freedom.
+ * **alerts**: A room for alerts and notifications for infrastructure and other
+ things.
+
+## Mailing Lists
+
+Below is a listing of all the public mailing lists on imfreedom.org. Click on a
+list name to get more information about the list, or to subscribe, unsubscribe,
+and change the preferences on your subscription.
+
+List administrators, you can visit
+[the list admin overview page <i class="fas fa-external-link-alt fa-sm"></i>][1]
+to find the management interface for your list.
+
+| List | Description |
+| ------------------------------------------------------------------ | ------------------------------------------------------------------------ |
+| [**Board** <i class="fas fa-external-link-alt fa-sm"></i>][2] | For use by the board of Instant Messaging Freedom, Inc. |
+| [**Discussion** <i class="fas fa-external-link-alt fa-sm"></i>][3] | Discussion of Instant Messaging Freedom, Inc.'s activities and proposals |
+| [**Open IM** <i class="fas fa-external-link-alt fa-sm"></i>][4] | Open discussion about all IM protocols |
+
+[1]: https://lists.imfreedom.org/admin
+[2]: https://lists.imfreedom.org/listinfo/board
+[3]: https://lists.imfreedom.org/listinfo/discussion
+[4]: https://lists.imfreedom.org/listinfo/openim
--- a/hugo/content/mailing.md Tue Jun 15 13:14:56 2021 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,25 +0,0 @@
----
-title: "Mailing List"
-date: 2018-05-03
----
-
-## Mailing Lists
-
-Below is a listing of all the public mailing lists on imfreedom.org. Click on a
-list name to get more information about the list, or to subscribe, unsubscribe,
-and change the preferences on your subscription.
-
-List administrators, you can visit
-[the list admin overview page <i class="fas fa-external-link-alt fa-sm"></i>][1]
-to find the management interface for your list.
-
-| List | Description |
-| ------------------------------------------------------------------ | ------------------------------------------------------------------------ |
-| [**Board** <i class="fas fa-external-link-alt fa-sm"></i>][2] | For use by the board of Instant Messaging Freedom, Inc. |
-| [**Discussion** <i class="fas fa-external-link-alt fa-sm"></i>][3] | Discussion of Instant Messaging Freedom, Inc.'s activities and proposals |
-| [**Open IM** <i class="fas fa-external-link-alt fa-sm"></i>][4] | Open discussion about all IM protocols |
-
-[1]: https://lists.imfreedom.org/admin
-[2]: https://lists.imfreedom.org/listinfo/board
-[3]: https://lists.imfreedom.org/listinfo/discussion
-[4]: https://lists.imfreedom.org/listinfo/openim
Binary file hugo/content/xmpp/add-account.png has changed
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/hugo/content/xmpp/index.md Tue Jun 22 19:35:31 2021 -0500
@@ -0,0 +1,49 @@
+---
+title: "XMPP"
+date: 2021-06-22
+---
+
+## imfreedom.org XMPP Service
+
+As mentioned on the [contact]({{< ref "contact" >}}) page, we run an XMPP
+instance for imfreedom.org. Accounts for this instance are tied to accounts
+on [hub](https://hub.imfreedom.org) and only work if you have been given access.
+Access is given to all current and former board members.
+
+To use this service, you'll need to add an account to your XMPP client. We'll
+walk through doing this in [Pidgin](https://pidgin.im/) below. Please note that
+if your [hub](https://hub.imfreedom.org) account has two factor authentication
+turned on, you will need to create and use an application password. See the
+Jetbrains Hub
+[documentation](https://www.jetbrains.com/help/hub/application-passwords.html)
+to learn how to do this.
+
+In the [Pidgin](https://pidgin.im/) "Add Account" dialog you need to enter
+the matching username for your [hub](https://hub.imfreedom.org) account. For
+the domain you need to enter `imfreedom.org`. You can then optionally set a
+resource to identify this client for yourself and others as well as a have
+[Pidgin](https://pidgin.im/) remember your password.
+
+{{< figure title="Add imfreedom.org Account Dialog" src="add-account.png" >}}
+
+Once everything looks correct, go ahead and click "Add" and the account should
+connect. If it doesn't please verify that all of the settings are correct
+including your password.
+
+Once you're connected you can join the board room by selecting
+`Buddies -> Join A Chat...` or by hitting `Ctrl-C` in the "Buddy List" window.
+This will open the "Join a Chat" dialog window.
+
+First you'll need to select the proper account if you have multiple accounts in
+this [Pidgin](https://pidgin.im/) instance. Next you'll want to enter `board`
+for the `Room` field. Server should be automatically set to
+`conference.imfreedom.org` but if it isn't please set it appropriately. You can
+also specify a custom "Handle" for yourself in this room. This handle is the
+name that is displayed to others. Once everything is set, go ahead and hit the
+join button.
+
+{{< figure title="Join a Chat Dialog" src="join-a-chat.png" >}}
+
+If everything went well you should have seen a new window, or a new tab in an
+existing window, pop up for the chat room. If this didn't happen please re-open
+the "Add a Chat" dialog and carefully re-enter the above settings.
Binary file hugo/content/xmpp/join-a-chat.png has changed