diff options
| author | Marshall Lochbaum <mwlochbaum@gmail.com> | 2021-09-14 16:33:10 -0400 |
|---|---|---|
| committer | Marshall Lochbaum <mwlochbaum@gmail.com> | 2021-09-14 16:33:10 -0400 |
| commit | c1ec8006fd1a637e7a647f06460d23c2b3e8e12b (patch) | |
| tree | 76bea10b1cbd66f1856445e886f09e2c673a0e2a /docs/index.html | |
| parent | f421346fa5a41fba61cd95dfb57fd4764b495f2d (diff) | |
Add standalone forums page
Diffstat (limited to 'docs/index.html')
| -rw-r--r-- | docs/index.html | 30 |
1 files changed, 27 insertions, 3 deletions
diff --git a/docs/index.html b/docs/index.html index b5ffce3d..458d4aa4 100644 --- a/docs/index.html +++ b/docs/index.html @@ -63,9 +63,33 @@ <p>If you're already an array programmer, you might start with the <a href="doc/index.html"><strong>documentation</strong></a> right away, using the <a href="doc/fromDyalog.html">BQN-Dyalog APL</a> or <a href="doc/fromJ.html">BQN-J</a> dictionary as a quick reference where appropriate. 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"><a class="header" href="#where-can-i-find-bqn-users">Where can I find BQN users?</a></h2> -<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. The Discord server has other array programming channels as well, with the corresponding Matrix channels gathered in <a href="https://app.element.io/#/room/%23array:matrix.org">this space</a> (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!</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> +<p>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 <a href="community/forums.html">here</a>.</p> +<table> +<thead> +<tr> +<th></th> +<th>Discord</th> +<th>Matrix</th> +<th>…in Element</th> +</tr> +</thead> +<tbody> +<tr> +<td>All rooms</td> +<td><a href="https://discord.gg/SDTW36EhWF"><strong>Invite</strong></a></td> +<td>#array:matrix.org</td> +<td><a href="https://app.element.io/#/room/%23array:matrix.org">Space</a></td> +</tr> +<tr> +<td>BQN room</td> +<td></td> +<td>#bqn:matrix.org</td> +<td><a href="https://app.element.io/#/room/%23bqn:matrix.org"><strong>Room</strong></a></td> +</tr> +</tbody> +</table> +<p><a href="https://en.wikipedia.org/wiki/Discord_(software)">Discord</a> is a popular commercial chat client and Element is a similar UI for the open chat protocol <a href="https://matrix.org/">Matrix</a>. 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 <a href="community/index.html">community</a> page for activities and such in other places.</p> +<p>Also feel free to contact me personally via Github issues or with the email address shown in my Github profile.</p> <h2 id="can-i-help-out"><a class="header" href="#can-i-help-out">Can I help out?</a></h2> <p>Certainly! There are never enough hours in the day and contributors from beginner to advanced programmers are all welcome. If you're interested I recommend you ask on the forums first to get a feel for what exactly is needed.</p> <p>You will certainly feel an urge to skip this paragraph and get to the fun stuff, but the most important resource for implementing a language is <strong>testing</strong> and the most valuable one for building a language community is accessible introductions to the language and <strong>learning materials</strong>. These are both very demanding, but if you're willing to put in the work to advance BQN in the most effective way then this is it. One form of documentation that many users would appreciate is short descriptions—a sentence or two with examples—of the primitives for each glyph that can be displayed as help in the REPL. To be honest I'm lousy at making these and would prefer for someone else to do it.</p> |
