From 117caba7c9d4ea7359f89ee07decacdbf58ee203 Mon Sep 17 00:00:00 2001 From: "Nicholas H.Tollervey" Date: Sun, 7 Jul 2024 11:26:19 +0100 Subject: [PATCH 1/2] WiP --- docs/beginning-pyscript.md | 5 +++++ docs/index.md | 11 ++++++----- docs/user-guide/what.md | 4 +++- 3 files changed, 14 insertions(+), 6 deletions(-) diff --git a/docs/beginning-pyscript.md b/docs/beginning-pyscript.md index e1bcf7e..5031fbb 100644 --- a/docs/beginning-pyscript.md +++ b/docs/beginning-pyscript.md @@ -59,6 +59,11 @@ refresh the page (`CTRL-R`) to see any updates you may have made. [Live Server extension](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer) can be used to reload the page as you edit your files. + Alternatively, if you have an account on [GitHub](https://github.com) you + could use VSCode in your browser as a + [PyScript aware "CodeSpace"](https://github.com/ntoll/codespaces-project-template-pyscript/) + (just follow the instructions in the README file). + If you decide to use [pyscript.com](https://pyscript.com) (recommended for first steps), once signed in, create a new project by pressing the "+" button on the left hand side below the site's logo. You'll be presented with a page diff --git a/docs/index.md b/docs/index.md index b50d38e..2cfbb01 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,6 +1,6 @@ ![PyScript Logo](assets/images/pyscript.svg) -

PyScript is a platform for Python in the browser.

+

PyScript is an open source platform for Python in the browser.

## PyScript is... @@ -22,18 +22,19 @@
I'm a beginner...
Welcome! PyScript is designed to be friendly for beginner coders. The - best place to start is by reading our + best way to start is to read our beginning PyScript guide - and then using + and then use pyscript.com - to create your first apps. Having problems? Check out our + to create your first apps. Problems? Check out our frequently asked questions.
I'm already technical...
The beginner docs will set you up with a simple coding environment. For more in-depth technical coverage of PyScript, consult the user guide. The example applications demonstrate many of the features - of PyScript. The FAQ contains lots of technical detail.
+ of PyScript. The API docs and FAQ + contain lots of technical detail.
I want to contribute...

Welcome, friend! diff --git a/docs/user-guide/what.md b/docs/user-guide/what.md index 4ce87ba..84304c1 100644 --- a/docs/user-guide/what.md +++ b/docs/user-guide/what.md @@ -1,6 +1,8 @@ # What is PyScript? -[PyScript](https://pyscript.net) is a platform for [Python](https://python.org) in the +[PyScript](https://pyscript.net) is an +[open source](../../license/) platform for +[Python](https://python.org) in the [browser](https://en.wikipedia.org/wiki/Web_browser). PyScript brings together two of the most vibrant technical ecosystems on the From ec6e33241e69d5efed01d79a32032af1d116318a Mon Sep 17 00:00:00 2001 From: "Nicholas H.Tollervey" Date: Sun, 7 Jul 2024 11:48:30 +0100 Subject: [PATCH 2/2] More updates for EuroPython. --- docs/user-guide/architecture.md | 4 ++-- docs/user-guide/first-steps.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/user-guide/architecture.md b/docs/user-guide/architecture.md index e383602..be311b6 100644 --- a/docs/user-guide/architecture.md +++ b/docs/user-guide/architecture.md @@ -73,8 +73,8 @@ PolyScript's capabilities, upon which PyScript is built, can be summarised as: defined moments in the page lifecycle, provide a means of calling user defined functions to modify and enhance PolyScript's default behaviour. * [Multiple interpreters](https://pyscript.github.io/polyscript/#interpreter-features) - (in addition to Pyodide and MicroPython, PolyScript works with Lua and Ruby - - although these are beyond the scope of this project). + (in addition to Pyodide and MicroPython, PolyScript works with R, Lua and + Ruby - although these are beyond the scope of this project). PolyScript may become important if you encounter problems with PyScript. You should investigate PolyScript if any of the following is true about your diff --git a/docs/user-guide/first-steps.md b/docs/user-guide/first-steps.md index 1c78a3c..314be79 100644 --- a/docs/user-guide/first-steps.md +++ b/docs/user-guide/first-steps.md @@ -123,7 +123,7 @@ attributes: The browser's tab displaying the website running PyScript is an isolated computing sandbox. Define the Python environment in which your code will run with [configuration options](configuration.md) (discussed later in this - document). + user guide). !!! tip