From e15ceafa58b5de2da2ee809b26032039b1ea0486 Mon Sep 17 00:00:00 2001 From: Peli de Halleux Date: Thu, 16 Mar 2017 14:35:10 -0700 Subject: [PATCH] updated docs --- docs/javascript/sequence.md | 59 ------------------------------------- docs/open-source.md | 1 + docs/streaming.md | 18 ++--------- 3 files changed, 4 insertions(+), 74 deletions(-) delete mode 100644 docs/javascript/sequence.md diff --git a/docs/javascript/sequence.md b/docs/javascript/sequence.md deleted file mode 100644 index 81f7d4a0..00000000 --- a/docs/javascript/sequence.md +++ /dev/null @@ -1,59 +0,0 @@ -# Sequencing - -By calling one function after another, in sequence, you can create an animation: - -```typescript -basic.showLeds(` - . # . # . - . . . . . - . . # . . - # . . . # - . # # # . - `); -basic.showLeds(` - . # . # . - . . . . . - . . . . . - . # # # . - # . . . # - `); -``` - -### The semicolon - -In JavaScript, the semicolon (;) is used to terminate (or end) a statement. However, in most -cases, the semicolon is optional and can be omitted. So both code sequences below are -legal: - -```typescript -basic.showNumber(1) -basic.showNumber(2) -``` - -```typescript -basic.showNumber(1); -basic.showNumber(2); -``` - -### The empty statement - -In JavaScript, there is the concept of an *empty statement*, which is whitespace followed by -a semicolon in the context where a statement is expected. -So, the following code is an infinite loop -followed by a call to `showNumber` that will never execute: -```typescript-ignore -while(true) ; -basic.showNumber(1); -``` - - -### ~hint -For the @boardname@, we don't allow a program to contain an empty statement, such as shown above. -If you really want an empty statement, you need to use curly braces to delimit an empty statement block: -```typescript -while(true) { } -basic.showNumber(1); -``` -### ~ - -[Read more](http://inimino.org/~inimino/blog/javascript_semicolons) about semicolons in JavaScript. diff --git a/docs/open-source.md b/docs/open-source.md index acfdc086..93082fe9 100644 --- a/docs/open-source.md +++ b/docs/open-source.md @@ -16,4 +16,5 @@ as well as a set of helper functions (such as displaying a number/image/string o ## Packages * [microsoft/pxt-neopixel](https://github.com/microsoft/pxt-neopixel), package for neopixel strips +* [microsoft/pxt-filesystem](https://github.com/microsoft/pxt-filesystem), package for the file system * [microsoft/pxt-max6675](https://github.com/microsoft/pxt-max6675), package for Temperature Probe (MAX6675) \ No newline at end of file diff --git a/docs/streaming.md b/docs/streaming.md index 208f25ea..bf87e435 100644 --- a/docs/streaming.md +++ b/docs/streaming.md @@ -1,12 +1,10 @@ -# Streaming +# @extends -This page describes how to stream data from the @boardname@ to the editor or even to the cloud. - -## Before starting... +## Before starting... #setup Make sure you follow the instructions on [how to setup a serial connection](/device/serial) with the @boardname@. -## A typical scenario +## A typical scenario #example A common scenario is to chart some sensor data, such as the acceleration, and analyse it in the editor. For example, run this code on your @boardname@. @@ -20,13 +18,3 @@ basic.forever(() => { If your serial connection is working, you will start to see a chart representing that acceleration ``x`` value read from the @boardname@. Each time ``led.plotBarGraph`` is called, the value is also written to the serial output. The log view automatically detects that there is a data stream and displays a graph. - -## Local download - -The log view will automatically start to collect and organize the data it detects. Simply click on the log view to open the various options -to export the data. The simplest option is to download the data as a **CSV file**. This file can easily be opened in programs like Office Excel. - -## Cloud upload via Azure - -In the data export dialog, there is another option to upload the data to the Azure cloud. This allows to upload small amounts of data -without any kind setup. The data can be accessed via web services or directly from Office Excel. \ No newline at end of file