Fix rendering issues, some typos / grammar etc

Author: Ivoz

core/files-templates.md

@@ -7,15 +7,15 @@ title: Files & Templates
 
 ## Files
 
-So you've seen how to send out some basic text with a simple flask application, and the languages that are used to build the web: HTML, CSS and Javascript. Serving text isn't enough though - what if we want to serve some actual files?
+So you've seen how to send out some basic text with a simple Flask application, and the languages that are used to build the web: HTML, CSS and Javascript. Serving text isn't enough though - what if we want to serve some actual files?
 
-Luckily, Flask comes prepared. All you have to do is **create a folder** in the same directory as `hello.py` with the special name of `static`. Any file you put in that folder will be served by flask automatically!
+Luckily, Flask comes prepared. All you have to do is **create a folder** in the same directory as `hello.py` with the special name of `static`. Any file you put in that folder will be served by Flask automatically! It's one of the nice functionalities provided to you by Flask's authors.
 
 You can do this with your computer's file browser, or on the command line by typing `mkdir static`.
 
 So, if you made a file in the static folder called `cats.gif`, and you'd normally access your application by visiting the url [http://127.0.0.1:5000](http://127.0.0.1:5000), then you can view that file by going to [http://127.0.0.1:5000/static/cats.gif](http://127.0.0.1:5000/static/cats.gif).
 
-**Check this works** for you by downloading a funny image from the internet (there are plenty at [imgur](http://imgur.com)), putting it in the static folder, running your flask application (`python hello.py`), and browsing to your image by the right url.
+**Check this works** for you by downloading a funny image from the internet (there are plenty at [imgur](http://imgur.com)), putting it in the static folder, running your Flask application (`python hello.py`), and browsing to your image by the right url.
 
 The `static` folder is a great place to put CSS stylesheets, Javascript script files, and images. Those files don't usually change much when a website is running, hence the folder name. A common practice is that web developers will organise these files in sub-directories called, for instance, `css`, `js`, and `img` respectively. 
 
@@ -42,9 +42,9 @@ In it, **create a file** called `index.html` and chuck some in some HTML -
 
 {% endraw %}
 
-This is a pretty simple HTML page, but it includes two simple bits of Flask's templating language. When Flask shows this template to your browser, it will replace `{{ author }}` and `{{ name }}` with what you assign those two variables in your application. If author was assigned to be "Bob", then the title of the page served will be "Bob's app".
+This is a pretty simple HTML page, but it includes two simple bits of Flask's templating language. When Flask shows this template to your browser, it will replace {% raw %}`{{ author }}` and `{{ name }}`{% endraw %} with what you assign those two variables in your application. If author was assigned to be "Bob", then the title of the page served will be "Bob's app".
 
-In this way a template separates what the content of the page should be, from the actual actual `data` that will be used as that content. This makes things a lot easier if you have to write a lot of dynamic web pages!
+In this way a template separates what the content of the page should be, from the actual actual _data_ that will be used as that content. This makes things a whole lot easier if you have to write a lot of dynamic web pages!
 
 Flask's templates can do a good deal more than just display variables, but we can get to that in good time.
 
@@ -53,8 +53,8 @@ Let's **modify our flask app** to serve this template:
     from flask import Flask, render_template
     app = Flask(__name__)
 
-    @app.route("/")
-    def hello():
+    @app.route('/')
+    def hello_world():
         author = "Me"
         name = "You"
         return render_template('index.html', author=author, name=name)
@@ -64,15 +64,15 @@ Let's **modify our flask app** to serve this template:
 
 You can see we imported a new function from `flask`, called `render_template`.
 
-Then in `hello()`, we added two variables called `author` and `name`. **Please change their values** from `"Me"` and `"You"` in your file, those are boring!
+Then in `hello_world()`, we added two variables called `author` and `name`. **Please change their values** from `"Me"` and `"You"` in your file, those are boring!
 
-Then instead of returning some text, we returned the result of calling `render_template`. First, we give it the file name of the template we wish to return. Then, we pass in the variable names that the template should know about (`author` and `name`) and what their values should be (...coincidentally, `author` and `name`!).
+Then instead of returning some text, we returned the result of calling `render_template`. First, we give it the file name of the template we wish to process. Then, we pass in the variable names that the template should know about (`author` and `name`) and what their values should be (...coincidentally, `author` and `name`!). This function should load up the template, do the proocessing required to replace placeholders with values, and return the full HTML text.
 
 Now try running and viewing your app, in all its HTML glory!
 
 ## A prettier home page
 
-Now that we have a bit more confidence in changing the home page let's look at making something a bit prettier. We want the home page of _Cats Everywhere_ to be fun and exciting. Something that says "Yes, these people know what they are doing. I will give them my email address in hope of seeing more of their work in future."
+Now that we have a bit more confidence in changing the home page we can look at making something a bit prettier. We want the home page of _Cats Everywhere_ to be fun and exciting. Something that says "Yes, these people know what they are doing. I will give them my email address in hope of seeing more of their work in future."
 
 This means fancy fonts, large bold type, huge banner images and nice round corners and things. We are going to need some more interesting HTML and a fair bit of CSS to get it looking pretty.