new falcon page

mattmakai · mattmakai · commit 0fde53f44756 · 2017-05-21T14:58:38.000-07:00
diff --git a/Makefile b/Makefile
@@ -6,5 +6,12 @@ run:
 	cp generated/updated_site/pages/* generated/updated_site/
 	rm -rf generated/updated_site/pages/
 
+
+update:
+	python update_s3.py
+	rm -rf generated/current_site
+	cp -R generated/updated_site generated/current_site
+
+
 init:
 	pip install -r requirements.txt
diff --git a/content/pages/02-development-environments/02-text-editors-ides.markdown b/content/pages/02-development-environments/02-text-editors-ides.markdown
@@ -12,8 +12,13 @@ Text editors and integrated development environments (IDEs) are applications
 for [writing code](/learning-programming.html). These applications are the
 primary user interface for developers to create their own programs.
 
+<img src="/img/visuals/vim-dark-bg.jpg" width="100%" alt="Vim with basic configuration options on a dark background." class="technical-diagram" style="border-radius: 5px;">
 
-## Why do I need a text editor or IDE?
+[Vim](/vim.html) is an example of a text editor implementation that can be 
+expanded into a full Python IDE using configuration files and plugins.
+
+
+## Why is a text editor or IDE necessary?
 Where will you write your code if you do not have a text editor? Your
 [development environment](/development-environments.html) must include
 a text editor so you can enter, edit and delete characters to create
@@ -23,7 +28,7 @@ Preferrably your editor will have a monospace font. It will also get out
 of your way, so no "smart" correction or automatic letter capitalization.
 
 
-## What's the difference between a text editor and an IDE?
+## What's the difference between text editors and IDEs?
 IDEs contain text editors but many text editors, for example Notepad included
 with Windows, do not include IDE features. Many text editors such as
 Vim or Emacs have IDE features by default but then can be further customized
diff --git a/content/pages/07-web-development/07-falcon.markdown b/content/pages/07-web-development/07-falcon.markdown
@@ -0,0 +1,37 @@
+title: Falcon
+category: page
+slug: falcon
+sortorder: 0707
+toc: False
+sidebartitle: Falcon
+meta: Falcon is a Python web framework designed for building fast RESTful APIs with minimal external dependencies.
+
+
+# Falcon
+[Falcon](https://falconframework.org/) is a 
+[WSGI-compliant](/wsgi-servers.html) [web framework](/web-frameworks.html)
+designed to build [RESTful APIs](/application-programming-interfaces.html)
+without requiring external code library dependencies.
+
+<a href="https://falconframework.org/" style="border: none"><img src="/img/logos/falcon.jpg" style="padding:20px 0 20px 0" width="100%" alt="Falcon web framework logo." class="technical-diagram" /></a>
+
+
+<div class="well see-also">Falcon is an implementation of the <a href="/web-frameworks.html">web frameworks</a> concept. Learn how these parts fit together in the <a href="/web-development.html">web development</a> chapter or view <a href="/table-of-contents.html">all topics</a>.</div>
+
+
+### Falcon resources
+* [Building Scalable RESTful APIs with Falcon and PyPy](https://impythonist.wordpress.com/2015/09/12/build-massively-scalable-restful-api-with-falcon-and-pypy/)
+  shows a to-do list example with Falcon running on PyPy.
+
+* [Getting started with the Falcon Framework (using Python)](http://www.giantflyingsaucer.com/blog/?p=4342)
+  provides a small example application you can build.
+
+* [Building a rate limiter in Python 3 with Falcon and run it via Docker](http://www.giantflyingsaucer.com/blog/?p=5910)
+  is an introductory tutorial for creating and running a simple but useful 
+  Falcon app and executing it within a [Docker](/docker.html) container.
+
+* The 
+  [official Falcon tutorial](http://falcon.readthedocs.io/en/stable/user/tutorial.html)
+  has a meaty guide for building and deploying your first Falcon web 
+  application.
+
diff --git a/content/pages/07-web-development/11-other-web-frameworks.markdown b/content/pages/07-web-development/11-other-web-frameworks.markdown
@@ -4,12 +4,28 @@ slug: other-web-frameworks
 sortorder: 0711
 toc: False
 sidebartitle: Other Web Frameworks
-meta: Python has dozens of web frameworks with differing philosophies. Learn more about frameworks on Full Stack Python.
+meta: Python has many web frameworks with differing philosophies. Learn more about frameworks on Full Stack Python.
 
 
 # Other Web Frameworks
-Python has a significant number of web frameworks outside the usual Django,
-Flask, Pyramid and Bottle suspects.
+Python has a significant number of newer and less frequently-used 
+[web frameworks](/web-frameworks.html) that are still worth your time to 
+investigate. The list on this page does not include the following web 
+frameworks that have their own dedicated pages:
+
+* [Django](/django.html)
+
+* [Flask](/flask.html)
+
+* [Pyramid](/pyramid.html)
+
+* [Bottle](/bottle.html)
+
+* [Falcon](/falcon.html)
+
+* [Morepath](/morepath.html)
+
+* [Sanic](/sanic.html)
 
 
 ## TurboGears
@@ -20,15 +36,6 @@ stack library (like Django) or as a micro framework.
 <a href="http://www.turbogears.org/" style="border: none;"><img src="/img/logos/turbogears.jpg" width="100%" alt="TurboGears logo." class="technical-diagram" style="border-radius: 5px;"></a>
 
 
-
-## Falcon
-[Falcon](http://falconframework.org/) is a minimalist web framework designed
-with web application speed as a top priority.
-
-* [Building a rate limiter in Python 3 with Falcon and run it via Docker](http://www.giantflyingsaucer.com/blog/?p=5910)
-  is an introductory tutorial for creating and running a simple but useful 
-  Falcon app.
-
 ## web.py
 [web.py](http://webpy.org/) is a Python web framework designed for simplicity
 in building web applications.
diff --git a/content/pages/12-meta/04-future-directions.markdown b/content/pages/12-meta/04-future-directions.markdown
@@ -47,6 +47,10 @@ Every page on Full Stack Python is a work-in-progress that can always
 use improvements. The following items on this list need some love and 
 attention.
 
+* Update newer pages such as [AWS Lambda](/aws-lambda.html), 
+  [Text editors and IDEs](/text-editors-ides.html) and
+  [Falcon](/falcon.html) pages with additional sections and resources.
+
 * [RQ](/redis-queue-rq.html): Add "Comparing Celery and RQ" and 
   "when is RQ useful?" sections.
 
diff --git a/static/img/logos/falcon.jpg b/static/img/logos/falcon.jpg
diff --git a/theme/templates/choices/falcon.html b/theme/templates/choices/falcon.html
@@ -0,0 +1,18 @@
+<h3>What web development topic do you want to learn next?</h3>
+<div class="row">
+    <div class="col-md-4">
+        <div class="well select-next">
+            {% include "choices/buttons/deployment.html" %}
+        </div>
+    </div>
+    <div class="col-md-4">
+        <div class="well select-next">
+            {% include "choices/buttons/flask.html" %}
+        </div>
+    </div>
+    <div class="col-md-4">
+        <div class="well select-next">
+            {% include "choices/buttons/source-control.html" %}
+        </div>
+    </div>
+</div>
diff --git a/theme/templates/table-of-contents.html b/theme/templates/table-of-contents.html
@@ -36,7 +36,7 @@ <h4 class="toc-subsection">1.2 <a href="/python-community.html">Python Community
 
 
 <h3>2. <a href="/development-environments.html">Development Environments</a></h3>
-<h4 class="toc-subsection">2.1 <span class="soon">Text Editors and IDEs</span></h4>
+<h4 class="toc-subsection">2.1 <a href="/text-editors-ides.html">Text Editors and IDEs</a></h4>
 <div class="toc"><a href="/vim.html">Vim</a></div>
 <div class="toc"><a href="/emacs.html">Emacs</a></div>
 <div class="toc soon">Sublime Text</div>
@@ -126,7 +126,7 @@ <h4 class="toc-subsection">7.1 <a href="/web-frameworks.html">Web Frameworks</a>
 <div class="toc"><a href="/pyramid.html">Pyramid</a></div>
 <div class="toc"><a href="/morepath.html">Morepath</a></div>
 <div class="toc"><a href="/sanic.html">Sanic</a></div>
-<div class="toc soon">Falcon</div>
+<div class="toc"><a href="/falcon.html">Falcon</a></div>
 <div class="toc"><a href="/other-web-frameworks.html">Other web frameworks</a></div>
 
 <h4 class="toc-subsection">7.2 <a href="/template-engines.html">Template Engines</a></h4>
