aboutsummaryrefslogtreecommitdiff
path: root/html.html
diff options
context:
space:
mode:
authorJakob Odersky <jakob@driver.xyz>2018-09-21 15:13:48 -0700
committerJakob Odersky <jakob@driver.xyz>2018-09-21 15:13:48 -0700
commit1df1ca79efb8b070e914bf2c293e99cf9321600c (patch)
treeb716c7f50320e3c11ddfcd47a07cb5875fde49c1 /html.html
downloadbest-practices-1df1ca79efb8b070e914bf2c293e99cf9321600c.tar.gz
best-practices-1df1ca79efb8b070e914bf2c293e99cf9321600c.tar.bz2
best-practices-1df1ca79efb8b070e914bf2c293e99cf9321600c.zip
Publish website
Diffstat (limited to 'html.html')
-rw-r--r--html.html78
1 files changed, 78 insertions, 0 deletions
diff --git a/html.html b/html.html
new file mode 100644
index 0000000..22d79d9
--- /dev/null
+++ b/html.html
@@ -0,0 +1,78 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+ <head>
+ <meta charset="utf-8" />
+ <meta name="generator" content="pandoc" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
+ <meta name="dcterms.date" content="2018-09-21" />
+ <title>Style Guide</title>
+ <style type="text/css">
+ code{white-space: pre-wrap;}
+ span.smallcaps{font-variant: small-caps;}
+ span.underline{text-decoration: underline;}
+ div.column{display: inline-block; vertical-align: top; width: 50%;}
+ </style>
+ <link rel="stylesheet" href="assets/lib/bootstrap/bootstrap.min.css">
+ <link rel="stylesheet" href="assets/lib/fontawesome/css/font-awesome.min.css">
+ <link rel="stylesheet" href="assets/stylesheets/main.css">
+ </head>
+ <body>
+ <header class="container">
+ <div style="text-align: center;">
+ <h1>Style Guide</h1>
+ <p class="subtitle">Software Engineering at Driver</p>
+ <nav class="my-4">
+ <a class="btn btn-light" href="css.html">
+ <img src="assets/images/css.svg" width="16px" class="img-fluid">
+ CSS
+ </a>
+ <a class="btn btn-light" href="git.html">
+ <img src="assets/images/git.png" width="16px" class="img-fluid">
+ Git
+ </a>
+ <a class="btn btn-light" href="html.html">
+ <img src="assets/images/html5.svg" width="16px" class="img-fluid">
+ HTML
+ </a>
+ <a class="btn btn-light" href="javascript.html">
+ <img src="assets/images/javascript.png" width="16px" class="img-fluid">
+ JavaScript
+ </a>
+ <a class="btn btn-light" href="scala.html">
+ <img src="assets/images/scala.png" width="16px" class="img-fluid">
+ Scala
+ </a>
+ <a class="btn btn-light" href="shell-script.html">
+ <img src="assets/images/bash.svg" width="16px" class="img-fluid">
+ Shell Script
+ </a>
+ </nav>
+ </div>
+ </header>
+ <div class="container">
+ This guide recommends stylistic and architectural best
+ practices, designed to make your code easier for others to
+ understand. It offers <em>guidelines</em> not <em>rules</em>,
+ and there are situations in which the advice offered
+ should be actively ignored.
+ <hr>
+ </div>
+ <main class="container">
+ <h2 id="html">HTML</h2>
+<ul>
+<li><p>Use svg’s over all other image formats when possible.</p></li>
+<li><p>All <code>&lt;img&gt;</code> tags should have <code>“alt”</code> text.</p></li>
+<li><p>Only use tables for tabular data (not for layout)</p></li>
+<li><p>Make use of html5 elements like <code>&lt;header&gt;</code>, <code>&lt;footer&gt;</code>, <code>&lt;nav&gt;</code>, <code>&lt;section&gt;</code>, etc.</p></li>
+</ul>
+<h3 id="browsers">Browsers</h3>
+<ul>
+<li>Avoid supporting versions of Internet Explorer before IE11.</li>
+</ul>
+ </main>
+ <footer class="small mt-6 mb-1">
+ <span class="date">2018-09-21</span>
+ | <a href="https://github.com/drivergroup/best-practices/blob/master/guides/html.md" style="display: inline-block;"><i class="fa fa-github"></i> Edit on GitHub</a>
+ </footer>
+ </body>
+</html>