aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMarshall Lochbaum <mwlochbaum@gmail.com>2020-11-29 10:31:28 -0500
committerMarshall Lochbaum <mwlochbaum@gmail.com>2020-11-29 10:31:28 -0500
commitd62ff23f453150a89d8910df129da8da2b7c5ddb (patch)
treecb44043e80fbf6b04cae5586fbd3017ecdac2d9f
parent1e557aef7de584cd471630adb13aeae549e0c3e1 (diff)
Add links to forums in README
-rw-r--r--README.md8
-rw-r--r--docs/index.html4
2 files changed, 12 insertions, 0 deletions
diff --git a/README.md b/README.md
index 6121964f..5ce28dc1 100644
--- a/README.md
+++ b/README.md
@@ -67,3 +67,11 @@ BQN's [**tutorials**](tutorial/README.md) are intended as an introduction to arr
If you're already an array programmer, then you're in better shape: the current [**documentation**](doc/README.md) covers nearly all differences from APL, and the BQN-Dyalog APL [dictionary](doc/fromDyalog.md) 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 [primitives](doc/primitive.md)—if these differences don't seem important to you then you don't understand them! BQN's [based array model](doc/based.md) 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 [syntactic roles](doc/context.md) 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 [functional programming](doc/functional.md).
A useful tool for both beginners and experienced users is [**BQNcrate**](https://mlochbaum.github.io/bqncrate/), 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.
+
+## Where can I find BQN users?
+
+Most BQN users are active on [The APL Orchard](https://chat.stackexchange.com/rooms/52405/the-apl-orchard) forum. If you (like me) don't have a Stack Overflow or Stack Exchange account with a few points you'll have to send an email to get forum access; see the instructions in the room description.
+
+The official place to ask BQN programming questions is [topanswers.xyz/apl](https://topanswers.xyz/apl). Tag your questions with "bqn", of course.
+
+In addition to these forums, you can contact me personally via Github issues or with the email address in my Github profile.
diff --git a/docs/index.html b/docs/index.html
index bea1fd23..81eb2ec4 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -57,3 +57,7 @@
<p>BQN's <a href="tutorial/index.html"><strong>tutorials</strong></a> are intended as an introduction to array programming with BQN. They assume only knowledge of elementary mathematics, but will probably be hard to follow if you have <em>no</em> programming experience. BQN has a lot in common with dynamically-typed functional languages like Lisp, Julia, or Javascript, so knowledge of these languages will be particularly helpful. However, there's a significant (but shrinking) gap between the last tutorial and existing documentation. If you're motivated, you may be able to get across by reading material on other array languages like APL, J, NumPy, or Julia.</p>
<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 BQN-Dyalog APL <a href="doc/fromDyalog.html">dictionary</a> 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>Most BQN users are active on <a href="https://chat.stackexchange.com/rooms/52405/the-apl-orchard">The APL Orchard</a> forum. If you (like me) don't have a Stack Overflow or Stack Exchange account with a few points you'll have to send an email to get forum access; see the instructions in the room description.</p>
+<p>The official place to ask BQN programming questions is <a href="https://topanswers.xyz/apl">topanswers.xyz/apl</a>. Tag your questions with &quot;bqn&quot;, of course.</p>
+<p>In addition to these forums, you can contact me personally via Github issues or with the email address in my Github profile.</p>