aboutsummaryrefslogtreecommitdiff
path: root/community
diff options
context:
space:
mode:
authorMarshall Lochbaum <mwlochbaum@gmail.com>2021-09-14 16:33:10 -0400
committerMarshall Lochbaum <mwlochbaum@gmail.com>2021-09-14 16:33:10 -0400
commitc1ec8006fd1a637e7a647f06460d23c2b3e8e12b (patch)
tree76bea10b1cbd66f1856445e886f09e2c673a0e2a /community
parentf421346fa5a41fba61cd95dfb57fd4764b495f2d (diff)
Add standalone forums page
Diffstat (limited to 'community')
-rw-r--r--community/README.md6
-rw-r--r--community/forums.md26
2 files changed, 30 insertions, 2 deletions
diff --git a/community/README.md b/community/README.md
index c3bdc618..71ee32b0 100644
--- a/community/README.md
+++ b/community/README.md
@@ -2,12 +2,14 @@
# BQN community links
-Yes, BQN has users! Forums where we discuss things are linked [on the main page](../README.md#where-can-i-find-bqn-users), and there are a few projects elsewhere as well.
+Yes, BQN has users! This page gathers links to work by the community. To get in touch, please use our [chat forums](forums.md).
+
+For code repositories using BQN, see:
* Github repositories [tagged BQN](https://github.com/topics/bqn)
* [bqn-rest](https://codeberg.org/ndrogers/bqn-rest), for web APIs
-You can also see BQN submissions on some sites that encourage shorter-form programming with the links below:
+And the links below point to BQN submissions on some sites that encourage shorter-form programming.
* [Rosetta Code](https://rosettacode.org/wiki/Category:BQN) (consider translating [APL versions](https://rosettacode.org/wiki/Category:APL)?)
* Stack Exchange [Code Golf & Coding Challenges](https://codegolf.stackexchange.com/search?tab=newest&q=BQN)
diff --git a/community/forums.md b/community/forums.md
new file mode 100644
index 00000000..5b6fa179
--- /dev/null
+++ b/community/forums.md
@@ -0,0 +1,26 @@
+*View this file with results and syntax highlighting [here](https://mlochbaum.github.io/BQN/community/forums.html).*
+
+# BQN chat forums
+
+| | Discord | Matrix | …in Element |
+|-----------|---------------------------------------------|-------------------|-------------|
+| All rooms | [**Invite**](https://discord.gg/SDTW36EhWF) | #array:matrix.org | [Space](https://app.element.io/#/room/%23array:matrix.org)
+| BQN room | | #bqn:matrix.org | [**Room**](https://app.element.io/#/room/%23bqn:matrix.org)
+
+The BQN forum consists of a [Matrix](https://matrix.org/) channel, and one room in a [Discord](https://en.wikipedia.org/wiki/Discord_(software)) server, that are bridged together. Neither is primary and there are many users on each, and a few that use both. The Discord server contains rooms for array programming in general and for other languages such as APL, J, and k, and these are individually bridged to other Matrix channels.
+
+#### Matrix
+
+To avoid having to hunt down all these channels they're gathered into the Matrix space linked above. Most clients don't yet support spaces; you can enable them as a beta feature and join the space to see the channels in it. There's nothing special about the channels so once you join one you'll be able to use it from any other Matrix client as well.
+
+Being an open protocol, Matrix allows third-party clients (Element is first-party, created by the protocols designers), and there are many available. Most are lacking in features or otherwise difficult to use. For a desktop client, [Nheko](https://github.com/Nheko-Reborn/nheko) seems to be the best chance of a good experience.
+
+#### BQNBot
+
+BQNBot will run your code from chat! Begin your message with `bqn)` and our friend (designation B-QN) will evaluate the rest and show the output. While putting your code in blocks `` `like this` `` is easier to read, the bot just operates on plain text and doesn't require it. For longer blocks, you can start a new line after `bqn)`, and use a multi-line code block, as shown below.
+
+ bqn)
+ ```
+ some←code←↕10 # Comment
+ code+some
+ ```