Style guide

<!DOCTYPE html>     <html class="no-js" lang="en">  <head> <meta charset="utf-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <title>Style guide</title> <meta name="description" content=""/> <meta name="viewport" content="width=device-width, initial-scale=1" /> <link rel="icon" type="image/x-icon" href="/static/favicon.ico"/> <link rel="stylesheet" href="/static/CACHE/css/output.7ac6b21eee6a.css" type="text/css"> <link href="https://fonts.googleapis.com/css?family=Lato|Roboto" rel="stylesheet"/> <link rel="stylesheet" type="text/css" href="/static/css/print.css" media="print" /> <script async src="https://www.googletagmanager.com/gtag/js?id=G-6Z87ZDEY5E"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'G-6Z87ZDEY5E'); </script> <script async='async' src='https://www.googletagservices.com/tag/js/gpt.js'></script> <script> var googletag = googletag || {}; googletag.cmd = googletag.cmd || []; </script> <script> googletag.cmd.push(function() { googletag.defineSlot('/21754636678/xml.com-1', [[160, 600], [120, 240], [300, 250]], 'div-gpt-ad-1550450394815-0').addService(googletag.pubads()); googletag.defineSlot('/21754636678/xml.com-2', [[300, 250]], 'div-gpt-ad-1550513522284-0').addService(googletag.pubads()); googletag.pubads().enableSingleRequest(); googletag.pubads().disableInitialLoad(); googletag.enableServices(); }); </script> <script> //load the apstag.js library !function(a9,a,p,s,t,A,g){if(a[a9])return;function q(c,r){a[a9]._Q.push([c,r])}a[a9]={init:function(){q("i",arguments)},fetchBids:function(){q("f",arguments)},setDisplayBids:function(){},targetingKeys:function(){return[]},_Q:[]};A=p.createElement(s);A.async=!0;A.src=t;g=p.getElementsByTagName(s)[0];g.parentNode.insertBefore(A,g)}("apstag",window,document,"script","//c.amazon-adsystem.com/aax2/apstag.js"); //initialize the apstag.js library on the page to allow bidding apstag.init({ pubID: '32676f4f-8458-484f-b742-dcd7ad80a504', //enter your pub ID here as shown above, it must within quotes adServer: 'googletag' }); apstag.fetchBids({ slots: [{ slotID: 'div-gpt-ad-1550450394815-0', //example: 'div-gpt-ad-1475102693815-0' slotName: '21754636678/xml.com-1', //example: '12345/box-1' sizes: [[160,600], [300,250], [120,400]] //example: [[300,250], [300,600]] }, { slotID: 'div-gpt-ad-1550513522284-0', //example: 'div-gpt-ad-1475185990716-0' slotName: '21754636678/xml.com-2', //example: '12345/leaderboard-1' sizes: [[300,250]] //example: [[728,90]] }], timeout: 2e3 }, function(bids) { // set apstag targeting on googletag, then trigger the first DFP request in googletag's disableInitialLoad integration googletag.cmd.push(function(){ apstag.setDisplayBids(); googletag.pubads().refresh(); }); }); </script> </head> <body class=""> <div class="title-bar hide-for-print" data-responsive-toggle="menu" data-hide-for="large"> <button class="menu-icon" type="button" value="Menu" data-toggle></button> <div class="title-bar-title">XML.com</div> </div> <div class="row"> <div class="top-bar hide-for-print" id="menu"> <div class="top-bar-left"> <a href="/"><img src="/static/img/XML_com_logo.svg" alt="XML.com logo"/></a> </div> <div class="top-bar-right"> <ul class="menu vertical medium-horizontal" data-responsive-menu="drilldown medium-dropdown" role="menubar"> <li class=""><a href="/">Home</a></li> <li class=" "> <a href="/articles/">Articles</a> </li> <li class=" "> <a href="/authors/">Authors</a> </li> <li class=" "> <a href="/news/">News</a> </li> <li class=" "> <a href="/job-board/">Job Board</a> </li> <li class="has-submenu "> <a href="/about/">About</a> <ul class="submenu menu vertical"> <li class=""> <a href="/about/contribute/">Contribute</a> </li> <li class=""> <a href="/about/style-guide/">Style guide</a> </li> <li class=""> <a href="/about/copyright/">Copyright</a> </li> <li class=""> <a href="/about/contact/">Contact</a> </li> <li class=""> <a href="/about/privacy/">Privacy Policy</a> </li> </ul> </li> <li class="has-form" style="background: transparent;"> <form id="cse-search-box" action="https://google.com/cse"> <input type="hidden" name="cx" value="partner-pub-9264479583913780:3063344556"/> <input type="hidden" name="ie" value="UTF-8" /> <input type="text" placeholder="Search" name="q" title="Google Search"/>  </form> </li> </ul> </div> </div> </div> <div class="row"> <div class="medium-9 columns"> <nav aria-label="You are here:" role="navigation"> <ul class="breadcrumbs"> <li><a href="/">Home</a></li> <li><a href="/about/">About</a></li> <li class="current">Style guide</li> </ul> </nav> <div id="content"> <div role="content" class="medium-12 columns"> <h1>Style guide</h1> <h2 class="subheader"></h2> <hr> <p>We don't prescribe a particular style for XML.com; our articles come from different authors and their style choices vary. These choices are all valid as long as the resulting article can be understood readily by most XML.com readers, and doesn't have grammatical mistakes (particularly those that make the article harder to understand). The few style guidelines we do have are for that reason.</p><p>XML.com readers are not all experts in XML, although many of them are experts in other fields. They are looking for information that is explained well, but not over-simplified. Aim for practical information that people can use to solve their business needs, written without too much jargon or formality.聽<span>If you are writing an article for experts, add links to information about key concepts to aid readers less familiar with your topic.</span></p> <div class="body"> <p>Avoid jargon or explain what it means.</p><p>Be consistent in your spelling - for example, if you use UK English in one part of the article, use it in the rest.</p><p>Be consistent in other grammatical choices as well. Examples are:</p><p></p><ul><li>Pick one of sentence case or title case for capitalization for the entire article.</li><li>Either end each list item in a list with a period (full stop), or end none of them with a period.</li></ul><p></p><p>Use the abbreviations i.e. and e.g. correctly, or use English words instead ('that is' and 'for example').</p><p>Use sufficient punctuation.</p><p>Avoid double negatives; the meaning may not be as clear as you think the rules of logic dictate it should be.</p><p>Use diagrams and examples where possible.</p><p>The <a href="http://www.economist.com/styleguide/introduction">introduction to the Economist's style guide</a> is a good summary.聽The <a href="http://alistapart.com/about/style-guide">A List Apart Style Guide</a> is also worth reading. You may wish to use a service like <a href="https://www.grammarly.com/">Grammarly</a> to help catch typos.</p> </div> </div> </div> </div> <aside id="sidebar" class="medium-3 columns"> <div class="row"> <center><h6>Also in This Section<center><h6> <ul class="side-nav"> <li><a href="/about/contribute/">Contribute</a></li> <li><a href="/about/style-guide/">Style guide</a></li> <li><a href="/about/copyright/">Copyright</a></li> <li><a href="/about/contact/">Contact</a></li> <li><a href="/about/privacy/">Privacy Policy</a></li> </ul> </div> </aside> </div> <div class="row column"> <hr class="dotted"/> </div> <footer class="row column"> <p><strong>© Textuality Services, Inc.</strong> except for those articles with named authors or copyright holders. All trademarks and registered trademarks appearing on XML.com are the property of their respective owners.</p> </footer> <script src="/static/CACHE/js/output.d5b0ccff8392.js"></script> </body> </html>

CINXE.COM

Style guide