Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions frontend/html5.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,19 @@

<!-- Document Summary -->

<!DOCTYPE html> <!-- Tells the browser that HTML5 version of HTML to be recognized by the browser -->
<html lang="en"></html> <!-- The HTML lang attribute is used to identify the language of text content on the web. This information helps search engines return language specific results, -->
<head></head> <!-- Contains Information specific to the page like title, styles and scripts -->
<!DOCTYPE html> <!-- Tells the web browser that the page is written in HTML5 -->
<html lang="en"></html> <!-- The HTML lang attribute is used to identify the language of text content on the web. This information helps search engines return language specific results -->
<head></head> <!-- Contains information specific to the page like title, styles, and scripts -->
<title></title> <!-- Title for the page that shows up in the browser title bar -->
<body></body> <!-- Content that the user will see -->


<!-- Document Information -->


<base/> <!-- Usefull for specifying relative links in a document -->
<base/> <!-- Useful for specifying relative links in a document -->
<style></style> <!-- Contains styles for the html document -->
<meta/> <!-- Contains additional information about the page, author, page description and other hidden page info -->
<meta/> <!-- Contains additional information about the page, author, page description, and other hidden page info -->
<script></script> <!-- Contains all scripts internal or external -->
<link/> <!-- Used to create relationships with external pages and stylesheets -->

Expand All @@ -39,10 +39,10 @@ <h1></h1> ... <h6></h6> <!-- All six levels of heading

<strong></strong> and <b></b> <!-- Makes text contained in the tag as bold -->
<em></em> and <i></i> <!-- Alternative way to make the text contained in the tag as italic -->
<del></del> <!-- Creates a strike through the text element -->
<del></del> <!-- Creates a strike through the text element -->
<pre></pre> <!-- Preformatted monospace text block with some spacing intact -->
<blockquote></blockquote> <!-- Contains long paragraphs of quotations often cited -->
<abbr></abbr> <!-- Contains abbreviations while also making the full form avaialable -->
<abbr></abbr> <!-- Contains abbreviations while also making the full form available -->
<address></address> <!-- Used to display contact information -->
<code></code> <!-- Used to display inline code snippets -->
<q></q> <!-- Defines a short inline quotation -->
Expand Down Expand Up @@ -85,9 +85,9 @@ <h1></h1> ... <h6></h6> <!-- All six levels of heading

<form action="url"></form> <!-- Form element creates a form and action="" specifies where the data is to be sent to when the visitor submits the form -->

<!-- Supported attributes -->
<!-- Supported Attributes -->

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why the capitalization here?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The comments on L7, L16, L26, L37, etc. are also capitalised - I've updated these comments to match the rest of the page.

method="somefunction()" <!-- Contains the type of request (GET, POST... etc) which dictates how to send the data of the form -->
enctype="" <!-- Dictates how the data is to be encoded when the data is sent to the web server. -->
enctype="" <!-- Dictates how the data is to be encoded when the data is sent to the web server -->
autocomplete="" <!-- Specifies if the autocomplete functionality is enabled or not -->
novalidate <!-- Dictates if the form will be validated or not -->
accept-charset="" <!-- Identifies the character encoding upon form submission -->
Expand All @@ -99,7 +99,7 @@ <h1></h1> ... <h6></h6> <!-- All six levels of heading

<input type="text/email/number/color/date"> <!-- Input is the input field where the user can input various types of data -->

<!-- Supported attributes -->
<!-- Supported Attributes -->
name="" <!-- Describes the name of the form -->
width="" <!-- Specifies the width of an input field -->
value="" <!-- Describes the value of the input information field -->
Expand All @@ -113,7 +113,7 @@ <h1></h1> ... <h6></h6> <!-- All six levels of heading

<select name=""></select> <!-- Describes a dropdown box for users to select from variety of choices -->

<!-- Supported attributes -->
<!-- Supported Attributes -->
name="" <!-- The name for a dropdown combination box -->
size="" <!-- Specifies the number of available options -->
multiple <!-- Allows for multiple option selections -->
Expand Down Expand Up @@ -144,7 +144,7 @@ <h1></h1> ... <h6></h6> <!-- All six levels of heading

<object data=""></object> <!-- Describes and embed file type including audio, video, PDF's, images -->

<!-- Supported attributes -->
<!-- Supported Attributes -->
type="" <!-- Describes the type of media embedded -->
height="" <!-- Describes the height of the object in pixels -->
width="" <!-- Describes the width of the object in pixels -->
Expand Down Expand Up @@ -182,12 +182,12 @@ <h1></h1> ... <h6></h6> <!-- All six levels of heading
<time></time> <!-- Identifies the time and date -->
<wbr> <!-- A line break within the content -->

<!-- Some other useful tags -->
<!-- Some Other Useful Tags -->

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why capitalize every word?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All the comments / section headers should either be capitalised or lowercased for consistency, I think.


<canvas></canvas> <!-- Allows to draw 2D shapes on the web page with the help of javascript -->
<map></map> <!-- Specifies an image map -->

<!-- Collective Character Obejcts -->
<!-- Collective Character Objects -->


&#34; &quot; Quotation Marks - "
Expand Down