Merge pull request #45 from ninioArtillero/overview-fixes

Author: cyblue9

_docs/guides/editor-support.md

@@ -55,10 +55,9 @@ manual setup stuff to get it working).
 | command                                                              | keybinding                                                                                  |
 |----------------------------------------------------------------------|---------------------------------------------------------------------------------------------|
 | `switch-to-extempore` (or start Extermpore if it's not running)      | <kbd class="nopretty">CTRL</kbd>+<kbd>C</kbd> <kbd class="nopretty">CTRL</kbd>+<kbd>Z</kbd> |
-| `extempore-connect-or-disconnect` ()                                 | <kbd class="nopretty">CTRL</kbd>+<kbd>C</kbd> <kbd class="nopretty">CTRL</kbd>+<kbd>J</kbd> |
+| `extempore-connect-or-disconnect`                                    | <kbd class="nopretty">CTRL</kbd>+<kbd>C</kbd> <kbd class="nopretty">CTRL</kbd>+<kbd>J</kbd> |
 | `extempore-send-dwim` (to evaluate current top-level form or region) | <kbd class="nopretty">CTRL</kbd>+<kbd>META</kbd>+<kbd>X</kbd>                               |
 | `extempore-send-region`                                              | <kbd class="nopretty">CTRL</kbd>+<kbd>C</kbd> <kbd class="nopretty">CTRL</kbd>+<kbd>R</kbd> |
-| `extempore-send-buffer`                                              | <kbd class="nopretty">CTRL</kbd>+<kbd>C</kbd> <kbd class="nopretty">CTRL</kbd>+<kbd>B</kbd> |
 |                                                                      |                                                                                             |
 
 To restart the Extempore process, just <kbd

_docs/overview/contributing.md

@@ -18,12 +18,12 @@ list](mailto:[email protected]).
 
 This documentation is built using [Jekyll](https://jekyllrb.com/), using the
 [Jekyll Doc](https://aksakalli.github.io/jekyll-doc-theme/) theme. Since it's
-all just markdown files in the `docs/` subdirectory, it's easy for others to
+all just markdown files in the `_docs/` subdirectory, it's easy for others to
 contribute.
 
 If you find problems, or can think of improvements, [fork away on
 GH](https://github.com/digego/extempore), edit the documentation source files
-and submit a pull request---there's a nice little "Edit on Github" link at the
+and submit a pull request---there's a nice little "IMPROVE THIS PAGE" link at the
 bottom of every page. We'd love these docs to become a real community effort.
 There will probably be a few broken links and other little things like that, so
 no pull request is too small to be appreciated :)
@@ -42,7 +42,8 @@ If you want to see your changes locally (which of course you do!) then you can
 run a local 'live' test server with
 
 ~~~~ sourceCode
-    bundle exec jekyll serve
+    bundle exec jekyll serve              # or
+    bundle exec jekyll serve --livereload # to have the site reload on save
 ~~~~
 
 ### Hosting

_docs/overview/philosophy.md

@@ -91,7 +91,7 @@ factor of two integers `a` and `b` using a brute-force approach:
                              (= (modulo b i) 0))
                         i
                         (hcf (- i 1))))))
-      (hcf (if (< a b) b a)))))
+      (hcf (if (< a b) a b)))))
 
 (hcf-scheme 10 15) ;; returns 5
 
@@ -102,7 +102,7 @@ factor of two integers `a` and `b` using a brute-force approach:
                           (= (modulo b i) 0))
                      i
                      (hcf (- i 1))))))
-      (hcf (if (< a b) b a)))))
+      (hcf (if (< a b) a b)))))
 
 (hcf_xtlang 10 15)  ;; returns 5
 ~~~~

_docs/overview/time.md

@@ -63,6 +63,7 @@ arpeggiated triad).
 (bind-func dsp:DSP
   (lambda (in time chan dat)
     (synth in time chan dat)))
+
 (dsp:set! dsp)
 
 ;; schedule three nodes to play in succession
@@ -216,7 +217,7 @@ will have moved on. You should always try to schedule your code execution
 ;; This is best (callback happens 4100 samples earlier than new time)
 (define loop
   (lambda (time)
-    (play-note time synth 60 80 1.0)
+    (play-note time synth 60 80 44100)
     (callback (+ time 40000) 'loop (+ time 44100))))
 
 (loop (now))
@@ -226,6 +227,8 @@ In the 'good' version of `loop`, the `time` passed as an argument to `loop` is
 exactly the same time as the scheduled callback time. The problem with this is
 that the next note needs to be scheduled at exactly the same time that the
 function is called. The note will always be late. The 'best' version schedules
-the callback just ahead of the time that we want the note to play. This gives us
-`4100` samples to execute the code to schedule the note before the note is
-required to sound.
+the callback just ahead of the time that you want the note to play. This gives
+Extempore `4100` samples to execute the code to schedule the note before the note
+is required to sound.
+Notice `*second*` has been replaced by its actual value in samples to make
+the time difference explicit.