WiP

Author: ntoll

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

docs/index.md

@@ -1,6 +1,6 @@
 ![PyScript Logo](assets/images/pyscript.svg)
 
-<h1 style="text-align: center; font-weight: bold;">PyScript is a platform for Python in the browser.</h1>
+<h1 style="text-align: center; font-weight: bold;">PyScript is an <u>open source</u> platform for Python in the browser.</h1>
 
 ## PyScript is...
 
@@ -22,18 +22,19 @@
 <dl>
   <dt><strong>I'm a beginner...</strong></dt>
   <dd>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
   <a href="beginning-pyscript">beginning PyScript guide</a>
-  and then using 
+  and then use
   <a href="https://pyscript.com/" target="_blank">pyscript.com</a>
-  to create your first apps. Having problems? Check out our
+  to create your first apps. Problems? Check out our
   <a href="faq">frequently asked questions</a>.</dd>
   <dt><strong>I'm already technical...</strong></dt>
   <dd>The beginner docs will set you up with a simple coding environment. For
   more in-depth technical coverage of PyScript, consult the
   <a href="user-guide">user guide</a>. The
   <a href="examples">example applications</a> demonstrate many of the features
-  of PyScript. The <a href="faq">FAQ</a> contains lots of technical detail.</dd>
+  of PyScript. The <a href="api">API docs</a> and <a href="faq">FAQ</a>
+  contain lots of technical detail.</dd>
   <dt><strong>I want to contribute...</strong></dt>
   <dd>
     <p>Welcome, friend!

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