diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/doc/index.html | 1 | ||||
| -rw-r--r-- | docs/index.html | 2 | ||||
| -rw-r--r-- | docs/tutorial/index.html | 3 |
3 files changed, 4 insertions, 2 deletions
diff --git a/docs/doc/index.html b/docs/doc/index.html index 4edd0d0e..7c297c5d 100644 --- a/docs/doc/index.html +++ b/docs/doc/index.html @@ -6,6 +6,7 @@ <div class="nav">(<a href="https://github.com/mlochbaum/BQN">github</a>) / <a href="../index.html">BQN</a></div> <h1 id="bqn-documentation"><a class="header" href="#bqn-documentation">BQN documentation</a></h1> <p>BQN's documentation describes what features it has, how to use them (with examples), and why they were chosen. For a linear introduction to the language, see the <a href="../tutorial/index.html">tutorials</a>. For all of the particulars without so much discussion, see the <a href="../spec/index.html">specification</a>.</p> +<p>The <a href="quick.html">quick start</a> page is a hands-on way to see what features BQN offers so you can start with the parts you're most interested in.</p> <p>Overview:</p> <ul> <li><a href="syntax.html">Syntax</a></li> diff --git a/docs/index.html b/docs/index.html index 962ea837..39b37b1f 100644 --- a/docs/index.html +++ b/docs/index.html @@ -91,6 +91,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>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>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. The documentation has a <a href="doc/quick.html">quick start</a> page which is a nice way to dive in.</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> diff --git a/docs/tutorial/index.html b/docs/tutorial/index.html index 0be5e0fc..7085238e 100644 --- a/docs/tutorial/index.html +++ b/docs/tutorial/index.html @@ -5,7 +5,7 @@ </head> <div class="nav">(<a href="https://github.com/mlochbaum/BQN">github</a>) / <a href="../index.html">BQN</a></div> <h1 id="bqn-tutorials"><a class="header" href="#bqn-tutorials">BQN tutorials</a></h1> -<p>BQN tutorials explain how to approach and use the language as a newcomer (or they try; please get in touch if you find that they skip ahead!). Tutorials are meant to explain key ideas and may ignore details that would be included in the <a href="../doc/index.html">documentation</a>; also unlike the documentation they're meant to be read in order, as each tutorial will build on ideas from the previous ones. But feel free to skim or jump around if you find you're reading things that are already obvious.</p> +<p>BQN tutorials explain how to approach and use the language as a newcomer (or they try; please get in touch if you find that they skip ahead!). Tutorials are meant to explain key ideas and may ignore details that would be included in the <a href="../doc/index.html">documentation</a>; also unlike the documentation they're meant to be read in order, as each tutorial will build on ideas from the previous ones. But feel free to skim or jump around if you find you're reading things that are already obvious. You may also want to check the <a href="../doc/quick.html">quick start</a> to get a broad idea of what BQN is about.</p> <p>Tutorials assume (pretty presumptively, really. Disgusting.) that you are already motivated to learn BQN and use simple rather than flashy examples. To see some of the possibilities you might instead check the <a href="../community/index.html">community links</a>, or browse the <a href="https://aplwiki.com/wiki/Main_Page">APL Wiki</a> as these languages are closely related.</p> <p>The tutorials available so far:</p> <table> @@ -41,6 +41,7 @@ </table> <p>Where to from here? I'd suggest the following documentation pages as starting points:</p> <ul> +<li><a href="../doc/quick.html">Quick start</a></li> <li><a href="../doc/block.html">Blocks</a>; maybe <a href="../doc/lexical.html">Lexical scoping</a> and <a href="../doc/control.html">Control flow</a></li> <li><a href="../doc/array.html">Arrays</a> and <a href="../doc/indices.html">Indices</a></li> <li><a href="../doc/namespace.html">Namespaces</a> and <a href="../doc/oop.html">Object-oriented programming</a></li> |
