From c3dbb547c0b998d68414fd314d89342958cb9995 Mon Sep 17 00:00:00 2001 From: Marshall Lochbaum Date: Sun, 10 Jul 2022 22:22:21 -0400 Subject: Links to quick start --- README.md | 2 +- doc/README.md | 2 ++ docs/doc/index.html | 1 + docs/index.html | 2 +- docs/tutorial/index.html | 3 ++- tutorial/README.md | 3 ++- 6 files changed, 9 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 0bf1d0e4..ed61e775 100644 --- a/README.md +++ b/README.md @@ -83,7 +83,7 @@ Also feel free to contact me personally via Github issues or with the email addr ## How do I get started? -BQN's [**tutorials**](tutorial/README.md) 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 *no* 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. +BQN's [**tutorials**](tutorial/README.md) 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 *no* 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 [quick start](doc/quick.md) page which is a nice way to dive in. If you're already an array programmer, you might start with the [**documentation**](doc/README.md) right away, using the [BQN-Dyalog APL](doc/fromDyalog.md) or [BQN-J](doc/fromJ.md) dictionary as a quick reference where appropriate. 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). diff --git a/doc/README.md b/doc/README.md index f0c5ae18..a5e37874 100644 --- a/doc/README.md +++ b/doc/README.md @@ -4,6 +4,8 @@ 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 [tutorials](../tutorial/README.md). For all of the particulars without so much discussion, see the [specification](../spec/README.md). +The [quick start](quick.md) page is a hands-on way to see what features BQN offers so you can start with the parts you're most interested in. + Overview: - [Syntax](syntax.md) - [Types](types.md) 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 @@
(github) / BQN

BQN documentation

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 tutorials. For all of the particulars without so much discussion, see the specification.

+

The quick start page is a hands-on way to see what features BQN offers so you can start with the parts you're most interested in.

Overview: