pyscript
diff --git a/‎docs/assets/images/pyscript.com.png
46.7 KB b/‎docs/assets/images/pyscript.com.png
46.7 KB
diff --git a/‎docs/beginning-pyscript.md
Lines changed: 26 additions & 19 deletions b/‎docs/beginning-pyscript.md
Lines changed: 26 additions & 19 deletions
diff --git a/‎docs/contributing.md
Lines changed: 16 additions & 12 deletions b/‎docs/contributing.md
Lines changed: 16 additions & 12 deletions
diff --git a/‎docs/developers.md
Lines changed: 8 additions & 2 deletions b/‎docs/developers.md
Lines changed: 8 additions & 2 deletions
diff --git a/‎docs/user-guide/examples.md renamed to ‎docs/examples.md b/‎docs/user-guide/examples.md renamed to ‎docs/examples.md
@@ -1,11 +1,14 @@
 # Beginning PyScript
 
-PyScript is a platform for running Python in modern web browsers.
+PyScript is a platform for running
+<a href="https://python.org/" target="_blank">Python</a>
+in modern web browsers.
 
-Create apps with a PyScript development environment: write code, curate the
 project's assets, and test your application.
+Create apps with a
+<a href="https://pyscript.com/" target="_blank">PyScript development environment</a>:
+write code, curate the project's assets, and test your application.
 
-To distribute a PyScript application, host it as a static web site, then click
+To distribute a PyScript application, host it on the web, then click
 on the link to your application. PyScript and the browser do the rest.
 
 This page covers these core aspects of PyScript in a beginner friendly manner.
@@ -38,12 +41,6 @@ Create these files with your favourite code editor on your local file system.
 Alternatively, [pyscript.com](https://pyscript.com) will take away all the pain
 of organising, previewing and deploying your application.
 
-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
-containing three columns (listing your files, showing your code and previewing
-the app). The "save" and "run" buttons do exactly what you'd expect.
-
 If you're using your local file system, you'll need a way to view your
 application in your browser. If you already have Python installed on
 your local machine, serve your files with the following command run from your
@@ -62,22 +59,31 @@ 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.
 
+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
+containing three columns (listing your files, showing your code and previewing
+the app). The "save" and "run" buttons do exactly what you'd expect.
+
+![PyScript.com](assets/images/pyscript.com.png)
+
 Let's build a simple PyScript application that translates English 🇬🇧 into
 Pirate 🏴‍☠️  speak. In order to do this we'll make use of the
 [arrr](https://arrr.readthedocs.io/en/latest/) library. By building this app
 you'll be introduced to all the core concepts of PyScript at an introductory
 level.
 
-You can see this application embedded into the page below:
+You can see this application embedded into the page below (try it out!):
 
 <iframe src="https://ntoll.pyscriptapps.com/piratical/v5/" style="border: 1px solid black; width:100%;min-height: 400px; border-radius: 0.2rem; box-shadow: var(--md-shadow-z1);"></iframe>
 
 Let's explore each of the three files that make this app work.
 
 ### pyscript.json
 
-This file tells PyScript and your browser about various configurable aspects of
-your application. Put simply, it tells PyScript what it needs in order to run
+This file tells PyScript and your browser about various
+[configurable aspects](../user-guide/configuration)
+of your application. Put simply, it tells PyScript what it needs in order to run
 your application. The only thing we need to show is that we require the third
 party `arrr` module to do the
 [actual translation](https://arrr.readthedocs.io/en/latest/).
@@ -106,8 +112,8 @@ module in the document's `<head>` tag:
       <meta charset="utf-8" />
       <meta name="viewport" content="width=device-width,initial-scale=1" />
       <title>🦜 Polyglot - Piratical PyScript</title>
-      <link rel="stylesheet" href="https://pyscript.net/releases/2024.4.1/core.css">
-      <script type="module" src="https://pyscript.net/releases/2024.4.1/core.js"></script>
+      <link rel="stylesheet" href="https://pyscript.net/releases/2024.5.1/core.css">
+      <script type="module" src="https://pyscript.net/releases/2024.5.1/core.js"></script>
   </head>
   <body>
 
@@ -157,8 +163,8 @@ In the end, our HTML should look like this:
       <meta charset="utf-8" />
       <meta name="viewport" content="width=device-width,initial-scale=1" />
       <title>🦜 Polyglot - Piratical PyScript</title>
-      <link rel="stylesheet" href="https://pyscript.net/releases/2024.4.1/core.css">
-      <script type="module" src="https://pyscript.net/releases/2024.4.1/core.js"></script>
+      <link rel="stylesheet" href="https://pyscript.net/releases/2024.5.1/core.css">
+      <script type="module" src="https://pyscript.net/releases/2024.5.1/core.js"></script>
   </head>
   <body>
     <h1>Polyglot 🦜 💬 🇬🇧 ➡️ 🏴‍☠️</h1>
@@ -232,7 +238,7 @@ Pirate-ish.
 Alternatively, [click here to see a working example of this app](https://ntoll.pyscriptapps.com/piratical/v5/).
 Notice that the bottom right hand corner contains a link to view the code on
 [pyscript.com](https://pyscript.com). Why not explore the code, copy it to your own
-account and change it to your satisfaction.
+account and change it to your satisfaction?
 
 ### From a web server
 
@@ -261,4 +267,5 @@ needed to build yet more interesting things of your own.
 
 PyScript is extremely powerful, and these beginner steps only just scratch the
 surface. To learn about PyScript in more depth, check out
-[our user guide](user-guide/index.md).
+[our user guide](user-guide/index.md) or
+[explore our example applications](../examples).
@@ -18,7 +18,7 @@ Bugs are tracked on the
 
 !!! warning "Check first"
 
-    Please check your bug has not already been reported by someone else byi
+    Please check your bug has not already been reported by someone else by
     searching the existing issues before filing a new one. Once your issue is
     filed, it will be triaged by another contributor or maintainer. If there
     are questions raised about your issue, please respond promptly.
@@ -50,6 +50,9 @@ If you have an interesting project, a cool hack, or an innovative way to
 implement a new capability or feature, please share your work and tell us about
 it so we can celebrate and amplify your contribution.
 
+- Show off your creation at our fortnightly
+  [PyScript FUN](https://discord.com/events/972017612454232116/1227275336115556402)
+  community call on discord.
 - Write up your creation in a blog post.
 - Share it on social media.
 - Create a demo video.
@@ -63,11 +66,16 @@ Please reach out to us if you'd like advice and feedback.
 As an open source project, PyScript has community at its core. In addition to
 the ways to engage already outlined, you could join our live community calls.
 
-- PyScript Community Call - weekly on Tuesdays. A coordination call for anyone
-  participating in the PyScript project.
-- PyScript FUN - held every two weeks on a Thursday, this call is an informal,
+- [PyScript Community Call](https://discord.com/events/972017612454232116/1227274094366556279)
+  - weekly on Tuesdays. A coordination call for anyone participating in the
+  PyScript project.
+- [Community Engagement Call](https://discord.com/events/972017612454232116/1227275045965922376)
+  - weekly on Wednesdays. A non-technical meeting where we coordinate how the
+  PyScript project engages with, nourishes and grows our wonderful community.
+- [PyScript FUN](https://discord.com/events/972017612454232116/1227275336115556402)
+  - held every two weeks on a Thursday, this call is an informal,
   supportive and often humorous "show and tell" of community created projects,
-  hacks and plugins.
+  hacks, feedback and plugins.
 
 Announcement of connection details is made via the PyScript
 [discord server](https://discord.gg/HxvBtukrg2).
@@ -117,7 +125,9 @@ git remote add upstream https://github.com/pyscript/pyscript.git
 git pull upstream main
 ```
 
-* ???
+* Contribute changes using the
+  [GitHub flow](https://docs.github.com/en/get-started/using-github/github-flow)
+  model of coding collaboration.
 
 ### License terms for contributions
 
@@ -140,9 +150,3 @@ the existing maintainers.
 
 The Project abides by the Organization's
 [trademark policy](https://github.com/pyscript/governance/blob/main/TRADEMARKS.md).
-
----
-
-Part of MVG-0.1-beta.
-Made with love by GitHub. Licensed under the
-[CC-BY 4.0 License](https://creativecommons.org/licenses/by-sa/4.0/).
 
@@ -253,9 +253,15 @@ is through this environment that you contribute to PyScript.
   [discussions section](https://github.com/pyscript/pyscript/discussions) of
   our GitHub repository.
 
-* Every Tuesday is a community video call, the details of which are posted onto
+* Every Tuesday is a [technical community video call](https://discord.com/events/972017612454232116/1227274094366556279),
+  the details of which are posted onto
   the discord server. Face to face technical discussions happen here.
 
-* Every two weeks, on a Thursday, is a PyScript FUN call, the details of which
+* Every Wednesday is a [non-technical community engagement call](https://discord.com/events/972017612454232116/1227275045965922376),
+  in which we organise how to engage with, grow and nourish our community.
+
+* Every two weeks, on a Thursday, is a
+  [PyScript FUN call](https://discord.com/events/972017612454232116/1227275336115556402),
+  the details of which
   are also posted to discord. Project show-and-tells, cool hacks, new features
   and a generally humorous and creative time is had by all.