diff --git a/README.md b/README.md index b5b10cc..f32fa10 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,7 @@ A list of everything that \*could\* go in the `` of your document - [Social](#social) - [Facebook Open Graph](#facebook-open-graph) - [Twitter Card](#twitter-card) + - [Twitter Privacy](#twitter-privacy) - [Google+ / Schema.org](#google--schemaorg) - [Facebook Instant Articles](#facebook-instant-articles) - [OEmbed](#oembed) @@ -30,8 +31,6 @@ A list of everything that \*could\* go in the `` of your document - [QQ Mobile Browser](#qq-mobile-browser) - [UC Mobile Browser](#uc-mobile-browser) - [App Links](#app-links) -- [Notes](#notes) - - [Performance](#performance) - [Other Resources](#other-resources) - [Related Projects](#related-projects) - [Other Formats](#other-formats) @@ -43,16 +42,19 @@ A list of everything that \*could\* go in the `` of your document ## Recommended Minimum -Below are the essential tags for basic, minimalist websites: +Below are the essential elements for any web document (websites/apps): ```html Page Title @@ -64,17 +66,23 @@ Below are the essential tags for basic, minimalist websites: Valid `` elements include `meta`, `link`, `title`, `style`, `script`, `noscript`, and `base`. +These elements provide information for how a document should be perceived, and rendered, by web technologies. e.g. browsers, search engines, bots, etc. + ``` html - + Page Title - + - + @@ -97,21 +105,27 @@ Valid `` elements include `meta`, `link`, `title`, `style`, `script`, `nos ## Meta ``` html - + + - - + - - - + @@ -173,7 +187,7 @@ Valid `` elements include `meta`, `link`, `title`, `style`, `script`, `nos ## Link ``` html - + @@ -240,12 +254,12 @@ Valid `` elements include `meta`, `link`, `title`, `style`, `script`, `nos + - ``` **[⬆ back to top](#table-of-contents)** @@ -256,7 +270,7 @@ Valid `` elements include `meta`, `link`, `title`, `style`, `script`, `nos - + @@ -285,6 +299,7 @@ Valid `` elements include `meta`, `link`, `title`, `style`, `script`, `nos - 📖 [Facebook Open Graph Markup](https://developers.facebook.com/docs/sharing/webmasters#markup) - 📖 [Open Graph protocol](http://ogp.me/) +- 🛠 Test your page with the [Facebook Sharing Debugger](https://developers.facebook.com/tools/debug/) ### Twitter Card @@ -299,7 +314,14 @@ Valid `` elements include `meta`, `link`, `title`, `style`, `script`, `nos ``` - 📖 [Getting started with cards — Twitter Developers](https://dev.twitter.com/cards/getting-started) -- 🛠 [Twitter Card Validator](https://cards-dev.twitter.com/validator) +- 🛠 Test your page with the [Twitter Card Validator](https://cards-dev.twitter.com/validator) + +### Twitter Privacy +If you embed tweets in your website, Twitter can use information from your site to tailor content and suggestions to Twitter users. [More about Twitter privacy options](https://dev.twitter.com/web/overview/privacy#what-privacy-options-do-website-publishers-have). +``` html + + +``` ### Google+ / Schema.org @@ -468,7 +490,7 @@ Since Chrome 31, you can set up your web app to "app mode" like Safari. - + ``` @@ -494,7 +516,7 @@ Since Chrome 31, you can set up your web app to "app mode" like Safari. - + ``` @@ -510,7 +532,7 @@ Since Chrome 31, you can set up your web app to "app mode" like Safari. - + @@ -527,20 +549,6 @@ Since Chrome 31, you can set up your web app to "app mode" like Safari. **[⬆ back to top](#table-of-contents)** -## Notes - -### Performance - -Moving the `href` attribute to the beginning of an element improves compression when GZIP is enabled, because the `href` attribute is used in `a`, `base`, and `link` tags. - -Example: - -``` html - -``` - -**[⬆ back to top](#table-of-contents)** - ## Other Resources - 📖 [HTML5 Boilerplate Docs: The HTML](https://github.com/h5bp/html5-boilerplate/blob/master/dist/doc/html.md) @@ -606,7 +614,7 @@ Check out all the super awesome [contributors](https://github.com/joshbuchea/HEA ## Author -**[Josh Buchea](http://joshbuchea.com/)** +**[Josh Buchea](https://joshbuchea.com/)** ## License