blob: 22d79d9c77e79f16429ed933c0191cd6b494f185 (
plain) (
tree)
|
|
<!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><img></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><header></code>, <code><footer></code>, <code><nav></code>, <code><section></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>
|
