From 68295c80d2d10b756d78ab22bc7fc80740425482 Mon Sep 17 00:00:00 2001 From: Graham Trott Date: Wed, 18 Mar 2020 11:02:25 +0000 Subject: [PATCH] Doc updates --- resources/md/intro.md | 6 +++--- resources/md/technical.md | 2 -- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/resources/md/intro.md b/resources/md/intro.md index daecfe7..1c6d300 100644 --- a/resources/md/intro.md +++ b/resources/md/intro.md @@ -16,11 +16,11 @@ Once you have edit access to an empty server directory, create an `index.html` f - + @@ -30,7 +30,7 @@ If all is well, when you type the URL of the site into your browser the message The upper half of the file is the _HEAD_ of the document. In here is a call to load the ~ec~ JavaScript engine that we'll be using instead of regular JavaScript. It's called from a _Content Delivery Network_ that takes files from the main source-code repository for ~ec~. Don't worry if this is all a bit too technical; it's not necessary to understand in order to use it. -The lower half of the file is the _BODY_ of the document, which contains everything your users are going to see. This example, being as simple as you can get, has a single element, a preformatted (`
`) element, inside which is the 1-line script that displays the popup message you just saw. ~ec~ scripts look a lot like English, and like human languages they use very few symbols. It's very easy to learn the basics and whatever you write always goes inside the `
` element we see here.
+The lower half of the file is the _BODY_ of the document, which contains everything your users are going to see. This example, being as simple as you can get, has a single element, a `
` element inside which is the 1-line script that displays the popup message you just saw. ~ec~ scripts look a lot like English, and like human languages they use very few symbols. It's very easy to learn the basics and whatever you write always goes inside the `
` element we see here.
 
 Now open `index.html` into your editor. This is the file we'll be using for this short demo. Replace the existing `...` section with the following:
 
diff --git a/resources/md/technical.md b/resources/md/technical.md
index ba98b7b..d3c31bd 100644
--- a/resources/md/technical.md
+++ b/resources/md/technical.md
@@ -8,8 +8,6 @@ By imposing structure we aim to reduce the opportunity for coding errors to be m
 
 At ~ec~ we take issue with this claim, for the following reasons:
 
-1. Frameworks greatly add to the size of the code base, and a primary rule of programming is that the more code you have the more places there are for bugs to hide.
-
 1. Frameworks reduce the scope for ingenuity, seeking to eliminate errors from the outset by reducing all programming effort to a simple process of following rules that relies more on learning the structure than on thinking about problems and solutions.
 
 1. Rather than imposing a straitjacket on developers, large monolithic systems should wherever possible be broken down into smaller units that work in cooperation with each other and are maintained independently - the classic "black box" approach. Each unit can use different design choices, depending on the job being done and the skills available to construct it.