From c1ec8006fd1a637e7a647f06460d23c2b3e8e12b Mon Sep 17 00:00:00 2001 From: Marshall Lochbaum Date: Tue, 14 Sep 2021 16:33:10 -0400 Subject: Add standalone forums page --- README.md | 11 ++++++++--- community/README.md | 6 ++++-- community/forums.md | 26 ++++++++++++++++++++++++++ docs/community/forums.html | 43 +++++++++++++++++++++++++++++++++++++++++++ docs/community/index.html | 5 +++-- docs/index.html | 30 +++++++++++++++++++++++++++--- 6 files changed, 111 insertions(+), 10 deletions(-) create mode 100644 community/forums.md create mode 100644 docs/community/forums.html diff --git a/README.md b/README.md index 161c0969..7bdce5a0 100644 --- a/README.md +++ b/README.md @@ -80,11 +80,16 @@ A useful tool for both beginners and experienced users is [**BQNcrate**](https:/ ## Where can I find BQN users? -There's a BQN [Matrix](https://matrix.org/) channel at #bqn:matrix.org, which you can see in the Element web client with [this link](https://app.element.io/#/room/%23bqn:matrix.org), and one on Discord that you can join with [this invite](https://discord.gg/SDTW36EhWF). The two channels are bridged so that comments in one appear in both. The Discord server has other array programming channels as well, with the corresponding Matrix channels gathered in [this space](https://app.element.io/#/room/%23array:matrix.org) (link uses Element's spaces beta). BQN and the other channels are very active: you wouldn't believe how many people are here to discuss arrays all day! +Chat forum links below; either of the bold ones will open in a browser without much hassle if you just want to get on quickly. Further forum details [here](community/forums.md). -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. +| | 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) -In addition to these forums, you can contact me personally via Github issues or with the email address shown in my Github profile. +[Discord](https://en.wikipedia.org/wiki/Discord_(software)) is a popular commercial chat client and Element is a similar UI for the open chat protocol [Matrix](https://matrix.org/). They're bridged together so that messages in one appear in the other. Most discussion happens on these (they're quite active), but see also the [community](community/README.md) page for activities and such in other places. + +Also feel free to contact me personally via Github issues or with the email address shown in my Github profile. ## Can I help out? 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 + ``` diff --git a/docs/community/forums.html b/docs/community/forums.html new file mode 100644 index 00000000..8406f4ef --- /dev/null +++ b/docs/community/forums.html @@ -0,0 +1,43 @@ + + + + BQN chat forums + +
(github) / BQN / community
+

BQN chat forums

+ + + + + + + + + + + + + + + + + + + + + + + +
DiscordMatrix…in Element
All roomsInvite#array:matrix.orgSpace
BQN room#bqn:matrix.orgRoom
+

The BQN forum consists of a Matrix channel, and one room in a Discord 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 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
+```
+
diff --git a/docs/community/index.html b/docs/community/index.html index 61b4d43c..a2a8000a 100644 --- a/docs/community/index.html +++ b/docs/community/index.html @@ -5,12 +5,13 @@
(github) / BQN

BQN community links

-

Yes, BQN has users! Forums where we discuss things are linked on the main page, 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.

+

For code repositories using BQN, see:

-

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.