Skip to content

Commit e8a2b4a

Browse files
Update Python editor content (#414)
1 parent 35bc614 commit e8a2b4a

File tree

2 files changed

+20
-21
lines changed

2 files changed

+20
-21
lines changed

software/micropython.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ It provides two services:
3232
- [microFS](https://microfs.readthedocs.io/en/latest/)
3333
A simple command line tool and module for interacting with the limited file system provided by MicroPython on the BBC micro:bit.
3434

35-
Finally, there are great [tutorials for MicroPython on the micro:bit](https://microbit-micropython.readthedocs.io/en/latest/tutorials/introduction.html).
35+
Finally, there are great [tutorials for MicroPython on the micro:bit](https://microbit-micropython.readthedocs.io/en/v2-docs/tutorials/introduction.html).
3636

3737
## What is MicroPython?
3838

@@ -120,7 +120,7 @@ Many people in the international Python community have contributed free-to-use r
120120

121121
### Documentation
122122

123-
Tutorials and API documentation for developers can be [found here](https://microbit-micropython.readthedocs.io/en/latest/).
123+
Tutorials and API documentation for developers can be [found here](https://microbit-micropython.readthedocs.io/en/v2-docs/).
124124

125125
### Logging an Issue with the Development Team
126126

software/python-editor.md

Lines changed: 18 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -11,35 +11,34 @@ lang: en
1111

1212
## Overview
1313

14-
The [Python Editor](https://python.microbit.org) is a free, browser based coding environment for creating [MicroPython]({{ "/software/micropython/" | relative_url }}) projects with the BBC micro:bit.
14+
The [Python Editor](https://python.microbit.org) is a free, open source, browser-based coding environment for creating [MicroPython]({{ "/software/micropython/" | relative_url }}) projects with the BBC micro:bit.
1515

16-
Use common snippets of code, add/remove files and modules, and upload/download .hex or .py files.
16+
### Documentation
1717

18-
The Python editor is based upon the [Ace editor](http://ace.c9.io) and includes syntax highlighting, code folding and (semi) intelligent auto-indentation.
18+
For using the editor:
1919

20-
### Source
20+
- The [Reference](https://python.microbit.org/v/3/reference), [Ideas](https://python.microbit.org/v/3/ideas) and [API](https://python.microbit.org/v/3/api) tabs in the editor itself
21+
- [User guide](https://microbit-micropython.readthedocs.io/en/latest/)
22+
- [MicroPython reference](https://microbit-micropython.readthedocs.io/en/v2-docs/) provides information and examples on using the API
2123

22-
The upstream source code for the Python Editor can be found at [github.com/bbcmicrobit/PythonEditor](https://github.com/bbcmicrobit/PythonEditor)
24+
For developing the editor or understanding how it works:
2325

24-
The micro:bit target depends a closed source versioning repository that facilitates releases at `/v/`, for example the beta editor [https://python.microbit.org/v/beta](https://python.microbit.org/v/beta) and previous releases.
26+
- [GitHub](https://github.com/microbit-foundation/python-editor-v3)
27+
- [Technical overview](https://github.com/microbit-foundation/python-editor-v3/blob/main/docs/tech-overview.md)
2528

26-
### Offline
29+
### Reusable software components
2730

28-
It is possible to use the Python Editor offline to generate, upload and download .hex or .py files. However, refreshing the browser resets the editor.
31+
The [micro:bit MicroPython simulator](https://github.com/microbit-foundation/micropython-microbit-v2-simulator#readme) is a separate component that you can embed in your own software projects.
2932

30-
### Documentation
33+
The [micro:bit connection](https://microbit-foundation.github.io/microbit-connection/) npm package is used to connect to and flash the micro:bit over WebUSB.
3134

32-
- [MicroPython reference](https://microbit-micropython.readthedocs.io/en/v1.0.1/) provides information and examples on using the blocks
33-
- [Developer setup](https://github.com/bbcmicrobit/PythonEditor/blob/master/README.rst)
34-
- [Filesystem](https://github.com/bbcmicrobit/PythonEditor/blob/master/docs/filesystem.md)
35-
- [Translation strategy](https://github.com/bbcmicrobit/PythonEditor/blob/master/docs/translations.md)
36-
- [Embedding the editor](https://github.com/bbcmicrobit/PythonEditor/blob/master/docs/embedEditor.md)
35+
The MicroPython file system that stores the user's Python code can be manipulated with the [microbit-fs](https://microbit-foundation.github.io/microbit-fs/) npm package.
3736

38-
### Community
37+
### Previous version
3938

40-
There are a variety of ways to get involved and interact:
39+
The micro:bit Python Editor (V2) is still available at [https://python.microbit.org/v/2](https://python.microbit.org/v/2) with source code at [https://github.com/bbcmicrobit/PythonEditor](https://github.com/bbcmicrobit/PythonEditor).
40+
41+
### Community
4142

42-
- Join the [micro:bit developer community on Slack]({{ "/community/" | relative_url }})
43-
- Raise a [Python Editor issue or feature request](https://github.com/bbcmicrobit/PythonEditor/issues)
44-
- Ask a question on the [MicroPython forum for micro:bit](https://forum.micropython.org/viewforum.php?f=17&sid=de047c3e944921889becbc00f02a918f)
43+
- Raise a [Python Editor issue or feature request](https://github.com/microbit-foundation/python-editor-v3/issues)
4544
- Help [Translate the Python Editor](https://support.microbit.org/en/support/solutions/articles/19000106022-translating-the-python-editor) into your own language.

0 commit comments

Comments
 (0)