aboutsummaryrefslogtreecommitdiff
path: root/docs/index.html
diff options
context:
space:
mode:
authorMarshall Lochbaum <mwlochbaum@gmail.com>2022-05-27 21:56:23 -0400
committerMarshall Lochbaum <mwlochbaum@gmail.com>2022-05-27 21:56:23 -0400
commitcce2056e7723c316e4523b8899068b5061b50cd5 (patch)
tree7e1b89e1b4afab887bca2484161b95a019228300 /docs/index.html
parent525ac8dad3fb20a6db0606549dda94617373a396 (diff)
Documentation covers the whole core language now
Diffstat (limited to 'docs/index.html')
-rw-r--r--docs/index.html1
1 files changed, 0 insertions, 1 deletions
diff --git a/docs/index.html b/docs/index.html
index e29d6286..2994f98a 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -92,7 +92,6 @@
<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="how-do-i-get-started"><a class="header" href="#how-do-i-get-started">How do I get started?</a></h2>
-<p><em>The documentation still has some pages missing (not many now), while the tutorials are probably less than half complete. I don't think this is much of an impediment any more. Ask about anything you find confusing on the forums.</em></p>
<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. The tutorials end abruptly right now, so you'll have to switch to the documentation, which is less structured.</p>
<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>