Re: [PATCH] Add and clarify matrix workarounds.

["Philipp Steinpaß" <philipp@xndr.de>]

Thank you for the remarks, they were all very helpfull.
If you want to include me in the copyright, you are free to use my full
name. It's in the mail header now.

P.S. Please feel free to comment on any potential problems with the
formatting of these patch mails, if you want to. It's my first time
using git via mail and I'd like todo it the proper way right away.

---
 participating.html | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/participating.html b/participating.html
index 811fcf4..10665ca 100644
--- a/participating.html
+++ b/participating.html
@@ -78,13 +78,18 @@ the web.
 <h3>Note for Matrix users</h3>
 
 <p>
-There appears to be an issue with Matrix's IRC bridge that prevents
-Matrix users from joining #spectrum.  The workaround is as follows:
-
-<ol>
-  <li>Post <q>!join #spectrum</q> in your "Freenode IRC Bridge" chat.</li>
-  <li>Accept the invitation you are sent.</li>
-</ol>
+There appears to be an issue with Matrix's IRC bridged room that prevents
+Matrix users from joining the channel with the normal alias
+#freenode_#spectrum:matrix.org. There are the following workarounds:
+
+<ul>
+  <li>Join the room via it's internal name:
+    <kbd>/join !ZsIiqZmCTSWHpTQWaw:matrix.org</kbd>.
+  <li>Join the room via
+    <a href="https://matrix.to/#/!ZsIiqZmCTSWHpTQWaw:matrix.org">matrix.to link</a>.</li>
+  <li>Ask the bridges appservice to invite you to the room:
+    <kbd>/msg @appservice-irc:matrix.org !join #spectrum</kbd> and accept the invite.
+</ul>
 
 <p>
 If you experience this issue, kindly report it to the people who run
-- 
2.28.0



Alyssa Ross writes:

> Philipp <philipp+spectrum@xndr.de> writes:
>
>> I'm a matrix user and fiddled around with the room there a bit. My
>> findings were that the room itself seems to be fine, but the pretty
>> alias is broken in some way that I don't understand. I came up with two
>> ways to join the room via the internal ID and I also took the liberty to
>> modify the old workaround a little and made it more precise.
>> ---
>>  participating.html | 14 ++++++++------
>>  1 file changed, 8 insertions(+), 6 deletions(-)
>
> Thanks for the patch!  This should be very helpful.  I have a couple of
> comments, but I'm happy to just fix them up myself if you prefer.
>
>> diff --git a/participating.html b/participating.html
>> index 811fcf4..58f2ff3 100644
>> --- a/participating.html
>> +++ b/participating.html
>> @@ -78,13 +78,15 @@ the web.
>>  <h3>Note for Matrix users</h3>
>>  
>>  <p>
>> -There appears to be an issue with Matrix's IRC bridge that prevents
>> -Matrix users from joining #spectrum.  The workaround is as follows:
>> +There appears to be an issue with Matrix's IRC bridged room that prevents
>> +Matrix users from joining the channel with the normal alias <q>#freenode_#spectrum:matrix.org</q>.  There are the following workarounds:
>
> Text should be wrapped as it is everywhere else (I wrap at 70 because
> it's the default in Emacs but it doesn't have to be exact).
>
> The room name also isn't really a quotation, so probably doesn't really
> make sense to be a <q>.  (I think I'd just not mark it up at all.)
>
>> +
>> +<ul>
>> +  <li>Join the room via it's internal name: <q>/join !ZsIiqZmCTSWHpTQWaw:matrix.org</q>.
>> +  <li>Join the room via <a href="https://matrix.to/#/!ZsIiqZmCTSWHpTQWaw:matrix.org">matrix.to link</a>.</li>
>> +  <li>Ask the bridges appservice to invite you to the room: <q>/msg @appservice-irc:matrix.org !join #spectrum</q> and accept the invite.</li>
>
> The messages probably make more sense as <kbd> than <q>.
> The </li> can also be omitted.
>
>> +</ul>
>>  
>> -<ol>
>> -  <li>Post <q>!join #spectrum</q> in your "Freenode IRC Bridge" chat.</li>
>> -  <li>Accept the invitation you are sent.</li>
>> -</ol>
>>  
>>  <p>
>>  If you experience this issue, kindly report it to the people who run
>> -- 
>> 2.28.0
>
> As I said above, I'm happy to just fix up the patch myself and apply it if
> you'd prefer.
>
> One more thing -- this probably makes you a (minor) copyright holder in
> this file.  Are you happy if I add "SPDX-FileCopyrightText: 2020
> Philipp" to the copyright header at the top of the file?  (You can give
> me a surname if you want, or not -- up to you.)  And would you prefer
> your email address be included in the notice, or not (either is fine)?