strategy
strategy (as in "scheme") n. : an elaborate and systematic plan of action
The BEST advice in the above strategy is to "make small changes." When you make lots of changes, then view the page in your Browser, and check it using W3C Markup Validation Service ... if things don't go as you expect, it may be difficult to find what you did wrong. Make small changes.
<!DOCTYPE html>
<!--
HTML and CSS 6th Edition: Comprehensive
Author:
Date:
Text Editor:
Filename: something_or_the_other.html
-->
<html lang="en">
<head>
<title>some_sort_of_name_or_the_other</title>
<meta charset="utf-8" />
<!-- java script that supports HTML5 for Browsers that do not -->
<script src="http://www.tulane.edu/~gnorth/modernizr.js"></script>
<!-- link(s) to a external style sheet(s) go here -->
<link href="name_of_some_stylesheet.css" rel="stylesheet" type="text/css" />
</head>
In-line comments included in your HTML, this is also called documentation, or decoration. When I ask you to decorate your HMTL, I am asking that you include in-line comments. Comments remind you what your HTML code is supposed to accomplish. Comments allow others to more easily understand your HTML. Most importantly for our class, comments make it possible for George to grade your work. The grading rubric for most every assignment will require you to include in-line comments that document the graded item of the assignment.
HTML with in-line comments should look similare to the sample HTML below. This is an example of how the above paragraph was styled. You can compare them, starting at the Horizontal Rule ...
<!-- Making a Horizontal Rule (Presentational Attribute), textbook p.51 (near Figure 1-41) -->
<hr />
<!-- a Paragraph (Grouping Element), textbook p.26 (near Figure 1-13) -->
<!-- use strong to bold text (Text Level Element), textbook p.45 (near Figure 1-35) -->
<!-- use span to apply text formating (in this case 'font-size' 50% bigger ) -->
<p>
<span style="font-size: 150%"><strong>In-line comments</strong></span> included in your HTML, this is also called documentation, or decoration. When I ask you to decorate your HMTL, I am asking that you include in-line comments. Comments remind you what your HTML code is supposed to accomplish. Comments allow others to more easily understand your HTML. Most importantly for our class, comments make it possible for George to grade your work. The grading rubric for most every assignment will require you to include in-line comments that document the graded item of the assignment. So, take note, that comments in HTML are coded differently than comments in CSS external style sheets.
</p>
<!-- a second Paragraph -->
<p>
HTML with in-line comments look like the sample HTML below. This is an example of how the above paragraph was styled. You can compare them, starting at the Horizontal Rule ...
</p>
Take note that comments in HTML are coded differently than comments in CSS external style sheets.
Comments in your HTML begin with <!-- and end with --> ... so ...
<!-- this would be a comment line in HTML -->
Comments in CSS external style sheets begin with /* and end with */ ... so ...
/* this would be a comment line in CSS external style sheet */
The comments you use to document your HTML and CSS will be unique to your work, and should not be copied from the above examples. No need to quote page numbers from the textbook, no need to state the obvious, i.e. <!-- Paragraph starts here --> or <!-- Big Font size -->
An appropriate CSS comment would be something on the order of this
/* Rubric Item # 6 : for 10 points, styles for the <body> section */
body { background-color: #030; margin: 6px; font-size: 100%; color: #000; }
An appropriate HTML comment would be something on the order of this
<!-- Rubric Item # 4 : for 3 points, coding a special character © (copy right) -->
© 2018, George Joseph North, Jr.
Don't worry, by the end of our Semester, you will be a documentation expert.