aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMarshall Lochbaum <mwlochbaum@gmail.com>2021-07-02 22:21:11 -0400
committerMarshall Lochbaum <mwlochbaum@gmail.com>2021-07-02 22:21:11 -0400
commit28ebb7461880ada932e52536887602b6be14beb9 (patch)
treeccfd57f35dc9c3c67e6d6a828ed4c545152e77fa /docs
parentd146434b577e11ed97d9e9e5659be05cd23d14ff (diff)
Minor updates about forums
Diffstat (limited to 'docs')
-rw-r--r--docs/commentary/orchard.html2
-rw-r--r--docs/index.html2
2 files changed, 2 insertions, 2 deletions
diff --git a/docs/commentary/orchard.html b/docs/commentary/orchard.html
index c1a80718..4f07c20d 100644
--- a/docs/commentary/orchard.html
+++ b/docs/commentary/orchard.html
@@ -9,5 +9,5 @@
<p>StackExchange chat requires a StackExchange account with enough reputation, or moderator-granted permissions, to talk, and sets a reputation threshold for some minor features within the chat as well. Those who don't use StackExchange have to make an account and send an email to get permission. While this filtering probably leads to a more dedicated forum base, it does this at the expense of keeping out a lot of people, including many who have a lot to contribute. I think this isn't a good tradeoff, and this seems to be the community concensus as well.</p>
<p>StackExchange is not built for bots, and existing tooling for it is not very good. At the time of writing the bot that used to link the APL Orchard to IRC #apl is able to write but not read posts, so that the link only runs one way.</p>
<p>For a while StackExchange offered significantly better chat features than other forums for discussing code. At least Matrix and TopAnswers are now at parity or better, and have less confusing quirks relative to mainstream forum software like Discord. They also make it easy to create new rooms, which is much harder on StackExchange.</p>
-<p>There are concerns about StackExchange moderation: while he has since <a href="https://chat.stackexchange.com/transcript/message/57444267#57444267">declared</a> language design discussions to be on topic, Dyalog employee Adám Brudzewsky previously <a href="https://chat.stackexchange.com/transcript/message/57361357#57361357">unilaterally changed</a> the topic rules for the forum, over the objections of all commenters at the time and all of the forum's most active users. To be clear, this was a minor offense: it is reasonable for a forum about APL to be dedicated to APL only even if it was inappropriate to force this rule on everyone. However, it demonstrates that the APL Orchard is in practice a Dyalog-controlled forum, and I would recommend using it only if you are looking for a Dyalog-controlled forum. Previously members of the community had discussed moving and experimented with TopAnswers (unsuccessfully in my opinion); this event resolved the coordination problem as forum members jumped to new Discord and Matrix BQN forums.</p>
+<p>There are concerns about StackExchange moderation: while he has since <a href="https://chat.stackexchange.com/transcript/message/57444267#57444267">declared</a> language design discussions to be on topic, Dyalog employee Adám Brudzewsky previously <a href="https://chat.stackexchange.com/transcript/message/57361357#57361357">unilaterally changed</a> the topic rules for the forum, over the objections of all commenters at the time and all of the forum's most active users. It's a minor offense, but this indicates to me that the APL Orchard is in practice a Dyalog-controlled forum, so I recommend using it only if that's what you're looking for. Previously members of the community had discussed moving and experimented with TopAnswers (unsuccessfully in my opinion). This event prompted many users to leave and was when the Discord and Matrix BQN forums were created. APL conversation has mostly moved back since then.</p>
<p>In addition to concerns about the APL Orchard specifically, StackExchange chat (along with StackOverflow) is owned by <a href="https://en.wikipedia.org/wiki/Stack_Exchange">Stack Exchange, Inc</a>. This company is no longer owned by its original creators, and in recent years has operated in a generally unscrupulous way—which has caused employees with ethical concerns to leave or even be fired, a progression that's unlikely to end well. <a href="https://meta.stackexchange.com/questions/333965/firing-mods-and-forced-relicensing-is-stack-exchange-still-interested-in-cooper">This thread</a> documents these issues. StackExchange chat is insulated from any such issues by being effectively unmaintained, which is hardly an ideal defense for your community's main forum.</p>
diff --git a/docs/index.html b/docs/index.html
index f31a1109..e626e11d 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -63,7 +63,7 @@
<p>If you're already an array programmer, then you're in better shape: the current <a href="doc/index.html"><strong>documentation</strong></a> covers nearly all differences from APL, and the <a href="doc/fromDyalog.html">BQN-Dyalog APL</a> or <a href="doc/fromJ.html">BQN-J</a> dictionary might also be a useful resource. However, you should be aware of two key differences between BQN and existing array languages beyond just the changes of <a href="doc/primitive.html">primitives</a>—if these differences don't seem important to you then you don't understand them! BQN's <a href="doc/based.html">based array model</a> is different from both a flat array model like J and a nested one like APL2, Dyalog, or GNU APL in that it has true non-array values (plain numbers and characters) that are different from depth-0 scalars. BQN also uses <a href="doc/context.html">syntactic roles</a> rather than dynamic type to determine how values interact, that is, what's an argument or operand and so on. This system, along with lexical closures, means BQN fully supports Lisp-style <a href="doc/functional.html">functional programming</a>.</p>
<p>A useful tool for both beginners and experienced users is <a href="https://mlochbaum.github.io/bqncrate/"><strong>BQNcrate</strong></a>, a searchable collection of BQN snippets to solve particular tasks. If you have a question about how you might approach a problem, give it a try by typing in a relevant keyword or two.</p>
<h2 id="where-can-i-find-bqn-users">Where can I find BQN users?</h2>
-<p>There's a BQN channel on <a href="https://matrix.org/">Matrix</a> (#bqn:matrix.org), which can be opened in the Element client with <a href="https://app.element.io/#/room/%23bqn:matrix.org">this link</a>, and one on Discord that you can join with <a href="https://discord.gg/SDTW36EhWF">this invite</a>. The two channels are bridged so that comments in one appear in both. It should also be possible to link in an IRC channel, so contact me or get on one of the existing forums if you'd like to discuss making one. Past BQN discussion has mostly taken place on the <a href="https://apl.chat">APL Orchard</a> forum, but with a good alternative available I <a href="commentary/orchard.html">don't recommend</a> it for discussing BQN.</p>
+<p>There's a BQN <a href="https://matrix.org/">Matrix</a> channel at #bqn:matrix.org, which you can see in the Element web client with <a href="https://app.element.io/#/room/%23bqn:matrix.org">this link</a>, and one on Discord that you can join with <a href="https://discord.gg/SDTW36EhWF">this invite</a>. The two channels are bridged so that comments in one appear in both. I can't remember the last day without some conversation here, so you can definitely get your questions answered fast.</p>
<p>BQNBot will run your code from chat! Begin your message with <code><span class='Value'>bqn</span><span class='Paren'>)</span></code> and our friend (designation B-QN) will evaluate the rest and show the output. While putting your code in blocks <code><span class='Modifier'>`</span><span class='Value'>like</span> <span class='Value'>this</span><span class='Modifier'>`</span></code> is easier to read, the bot just operates on plain text and doesn't require it.</p>
<p>In addition to these forums, you can contact me personally via Github issues or with the email address shown in my Github profile.</p>
<h2 id="can-i-help-out">Can I help out?</h2>