<commit_before>![](https://az31353.vo.msecnd.net/c04/uxoj.png)
# TouchDevelop

TouchDevelop is a touch-friendly app creation environment for iPad, iPhone, Android, Windows, Mac, Linux developed with <3 at Microsoft Reasearch. Our mobile-friendly editor makes coding fun, even on your phone or tablet!

**This repo contains the source code of
the TouchDevelop editor.** If you are looking
to write TouchDevelop scripts, you probably
want to go to touchdevelop.com:
* **stable:** https://www.touchdevelop.com/app
* **beta:** https://www.touchdevelop.com/app/beta


## what's it in this repo?

The repo is mostly written in [Typescript](http://www.typescriptlang.org/) with tiny pieces
of HTML gluing.

This repo contains the source code for:
* the browser client
 * the compiler
 * the editor
 * the runtime
* the node.js client

However, you will not find the cloud backend running on
https://www.touchdevelop.com that takes care of storing and managing the scripts.

## how can I contribute?

There are many ways to [contribute](https://github.com/Microsoft/TouchDevelop/blob/master/CONTRIBUTING.md) to TouchDevelop.
* [Submit bugs](https://github.com/Microsoft/TouchDevelop/issues) and help us verify fixes as they are checked in.
* Review the [source code changes](https://github.com/Microsoft/TouchDevelop/pulls).
* [Contribute bug fixes or features](https://github.com/Microsoft/TouchDevelop/blob/master/CONTRIBUTING.md).

## how to build

In order to build TouchDevelop, ensure that you have [Git](http://git-scm.com/downloads) and [Node.js](http://nodejs.org/) installed.

Clone a copy of the repo:

    git clone https://github.com/Microsoft/TouchDevelop.git

Change to the TouchDevelop directory:

    cd TouchDevelop

Install Jake tools and dev dependencies:

    npm install -g jake
    npm install

Build the tree

Use one of the following to build and test:

    jake            # Build locally

## how to run this thing locally

After building, you can run TouchDevelop from a local node server by running

    td
<commit_msg>adding more docs<commit_after>![](https://az31353.vo.msecnd.net/c04/uxoj.png)
# TouchDevelop

TouchDevelop is a touch-friendly app creation environment for iPad, iPhone, Android, Windows, Mac, Linux developed with <3 at Microsoft Reasearch. Our mobile-friendly editor makes coding fun, even on your phone or tablet!

**This repo contains the source code of
the TouchDevelop editor.** If you are looking
to write TouchDevelop scripts, you probably
want to go to touchdevelop.com:
* **stable:** https://www.touchdevelop.com/app
* **beta:** https://www.touchdevelop.com/app/beta

Other pages of interrest:
* landing page: https://www.touchdevlop.com
* blog: https://www.touchdevelop.com/blog
* Hour Of Code tutorials: https://www.touchdevelop.com/hoc

## what's in this repo

The repo is mostly written in [Typescript](http://www.typescriptlang.org/) with tiny pieces
of HTML gluing.

This repo contains the source code for:
* the browser client
 * the compiler
 * the editor
 * the runtime
* the node.js client

However, you will not find the cloud backend running on
https://www.touchdevelop.com that takes care of storing and managing the scripts. The client uses the [cloud services](https://www.touchdevelop.com/help/cloudservices) provided by the TouchDevelop backend.

## how can I contribute

There are many ways to [contribute](https://github.com/Microsoft/TouchDevelop/blob/master/CONTRIBUTING.md) to TouchDevelop.

* [submit bugs](https://github.com/Microsoft/TouchDevelop/issues) and help us verify fixes as they are checked in.
* Review the [source code changes](https://github.com/Microsoft/TouchDevelop/pulls)
* [contribute bug fixes or features](https://github.com/Microsoft/TouchDevelop/blob/master/CONTRIBUTING.md).

If you're not a developer but still would like to help,
you've more tasks for you!

* [help translate the user inferface](https://touchdeveloptranslator.azurewebsites.net), do you use TouchDevelop and speak a foreign language? You can help!

## how to build

In order to build TouchDevelop, ensure that you have [Git](http://git-scm.com/downloads) and [Node.js](http://nodejs.org/) installed.

Clone a copy of the repo:

    git clone https://github.com/Microsoft/TouchDevelop.git

Change to the TouchDevelop directory:

    cd TouchDevelop

Install Jake tools and dev dependencies:

    npm install -g jake
    npm install

Build the tree

Use one of the following to build and test:

    jake            # Build locally

## where are the docs

All the docs available online at
> https://www.touchdevelop.com/docs

The docs are
authored as TouchDevelop scripts in TouchDevelop itself. You can fork them
and send pull requests from TouchDevelop itself to update them.

{'fraction_non_alphanumeric': 0.09284659210803967, 'fraction_numerical': 0.0033762397130196243, 'mean_word_length': 4.231788079470198, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 4, 'https://': 24, 'lorem ipsum': 0, 'www.': 13, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 34, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3557638', 'n_tokens_mistral': 1402, 'n_tokens_neox': 1290, 'n_words': 540}