Update README

This commit is contained in:
jakergrossman 2021-11-27 17:18:15 -06:00
parent c0f23d6de1
commit 1c8d9422a3
2 changed files with 52 additions and 18 deletions

View File

@ -1,35 +1,69 @@
# Mind_Reader <!-- header with logo -->
The current editor options available lack the level of accessibility that is <p align="center">
required to allow students who are visually impaired to adequately edit, write, <img alt="Mind Reader Logo" src="./media/logo.png"></img>
and debug code. This tool would extend Visual Studio Codes existing </p>
accessibility options to allow everyone, primarily students K-12, to learn
programming with Lego Mindstorms. Our goal is to provide an enhanced experience
for students who are visually impaired that is transparent to sighted students.
This allows for everyone to use the same software solution, whether or not they
are vision impaired.
<h1>Mind_Reader</h1>
<!-- overview description -->
The current editor options available lack the level of accessibility that is
required to allow people who are visually impaired to adequately write, edit,
and debug code.
This tool extends Visual Studio Codes existing
accessibility options to enable people with a visual impairment to learn
Python programming with LEGO Mindstorms. Our goal is to:
- provide an accessible experience to people with a visual impairment
- **not** change the editing workflow for people without a visual impairment
## Major Features
- Compatibility with major screen readers:
- [NVDA](https://www.nvaccess.org/)
- [JAWS](https://www.freedomscientific.com/products/software/jaws/)
- [Apple VoiceOver](https://support.apple.com/guide/voiceover-guide/welcome/web/)
<!-- TODO: still need this -->
- Play audio alerts for syntax and runtime errors.
- Present a summary of the scope for an individual line of code.
- Save and load programs directly onto the LEGO Hub from within Visual Studio Code
# For Developers
## Dependencies ## Dependencies
<!-- TODO: version information -->
<!-- TODO: how to support native-usb functionality? -->
- [Git](https://git-scm.com/) - [Git](https://git-scm.com/)
- [Node.js](https://nodejs.org/en/) - [Node.js](https://nodejs.org/en/)
See ["Your First ## Development Quick Start
Extension"](https://code.visualstudio.com/api/get-started/your-first-extension)
API page if you need more help.
## Cloning & Setup
Use the following to set up the extension for development. Use the following to set up the extension for development.
git clone https://github.com/SingleSemesterSnobs/Mind_Reader.git ```console
cd Mind_Reader $ git clone https://github.com/SingleSemesterSnobs/Mind_Reader.git
npm install $ cd Mind_Reader
$ npm install
```
While inside the repository do While inside the repository do
code . ```console
$ code .
```
to open the cloned repository in VS Code. to open the cloned repository in VS Code.
Then, use "Run > Start Debugging" on the menu bar to start the [Extension Then, use "Run > Start Debugging" on the menu bar to start the [Extension
Development Host](https://code.visualstudio.com/api/advanced-topics/extension-host) Development Host](https://code.visualstudio.com/api/advanced-topics/extension-host)
(<kbd>F5</kbd> by default). (<kbd>F5</kbd> by default).
---
See the Visual Studio Code [getting started](https://code.visualstudio.com/api/get-started/your-first-extension)
API page if you need more help.

BIN
media/logo.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB