Merge pull request #932 from alexmojaki/clarify-serve

Clarify difference between RunestoneServer and `runestone serve`

Author: bnmnetp

README.rst

@@ -77,15 +77,12 @@ To build the included default project run
 
     runestone build
 
-You will now have a build folder with a file index.html in it, along with some default content.  The contents of the build folder are suitable for hosting anywhere that you can serve static web content from!  For a small class you could even serve the content using the builtin Python webserver.
-
 *Note:* If you come across version conflict with ``six`` library while building the project, ``pip install --ignore-installed six`` command might be useful.
 
-::
+You will now have a build folder with a file index.html in it, along with some default content.  The contents of the build folder are suitable for hosting anywhere that you can serve static web content from!  For a small class you could even serve the content using the provided Python webserver::
 
     $ runestone serve
 
-
 Now from your browser you can open up ``http://localhost:8000/index.html``  You should see the table of contents for a sample page like this:
 
 .. image:: images/runeCompo-index.png

runestone/__main__.py

@@ -126,6 +126,9 @@ def build(all, wd):
 @click.option('--port', default=8000, help="port for server to listen on")
 @click.option('--listen', default="", help="address for server to listen on")
 def serve(port,listen):
+    click.echo("Note: this is a minimal static server without templates or a database.")
+    click.echo("For many use cases this is fine.")
+    click.echo("For the full server, see https://github.com/RunestoneInteractive/RunestoneServer")
     os.chdir(findProjectRoot())
     sys.path.insert(0,os.getcwd())
     try: