Style Guide

<h1>Bodhi Linux - Style Guide</h1> The purpose of a <strong>style guide</strong> is to aid in the standardization of documentation on the Bodhi Linux Wiki. A style guide helps maintain consistency across wikis and assists with creating new guides, tutorials and other documentation. A style guide can also be indispensable for updating and maintaining documentation. <h2>Conventions</h2> Please spell out "Bodhi Linux" for every reference as this is the name of our distribution (<em>distro</em> for short); do not shorten to "Bodhi", etc. Watch for typos of "Bodhi Linux" A term being defined or newly introduced topic should be <strong>bolded</strong> - see the introduction paragraph example Software names and proper nouns are to be capitalized - an example is Moksha File paths are to be set in monospaced font; in the Wiki this is accomplished by selecting "preformatted" - an example is - <code>/home/user/downloads/</code> <p style="padding-left: 30px;">or alternatively  &lt;code&gt;/example/path/&lt;/code&gt; - which displays as -<code>/example/path/</code></p> Blocks of code should by formatted as &lt;pre&gt;command&lt;/pre&gt; - such as <pre>sudo apt update &amp;&amp; sudo apt dist-grade</pre> Strings that need to be typed/entered should be <em>italicized</em> Items that need to be opened or selected from a menu or list should be spelled out and capitalized exactly how the Item appears Key presses should be formatted - &lt;keyname&gt; The "Win" key or "Windows" key - &lt;Superkey&gt; Hotkey combinations should be formatted - &lt;keyname&gt;+&lt;otherkey&gt; Hotkey sequences should be - &lt;keyname&gt; + &lt;otherkey&gt; Menu navigation - <em>Menu &gt; SubMenu &gt; SubSubMenu</em> Hyperlinks will automatically format to be <a href="https://www.bodhilinux.com/w/style_guide/">orange</a> - no need to bold, italicize, etc. Go easy with bolding and other emphasis - overuse overwhelms - please feel free to remove "excessive" bolding <h2>Page Organization</h2> Pages must have a current permalink that reflects page contents at the broadest level - permalinks should be adjusted as content develops, as needed. Pages should open with a Title that more-or-less matches the permalink. This section should be styled as "Heading 1". Following the title should be an introduction - a sentence or paragraph on the topic - background, use, etc.. Subsections follow nesting; that is, subheadings are "Heading 2" style. Sub-subheadings and are "Heading 3", etc.. Utilizing these predefined styles will create links to the sub-content, which is handy for assisting with troubleshooting - pasting links into the forum, Discord, etc.. Following each title/heading/sub-heading should be the content for that section; this follows the "Paragraph" style. Spacing between paragraphs is accomplished by pressing &lt;shift&gt;+&lt;enter&gt; Bullets should be used for lists Tips, Notes and Cautions and quotes should be italicized and also formatted with &lt;p style="padding-left: 30px;"&gt;<em>Note: example items</em>&lt;/p&gt;   (50px is being considered) - Tips are helpful and handy advice for users - items that save time, shortcuts, etc. Notes generally provide more information to a topic (trivia, anecdote, etc.) or external links for more resources "Caution" is used to make users aware of  items that may cause damage and may be stylized as Caution, CAUTION, ***CAUTION*** depending on the level of risk: slowing down a process or having to repeat a task is different than typing a command that could nuke a system. Use your discretion or poll the experts. Pages should end with navigation back to the Wiki Home Page, Wiki Table of Contents and other related helpful links. Example: <em>Further exploration:</em> Back to <a href="https://www.bodhilinux.com/w/moksha-guide/">Moksha Guide</a> <a href="https://www.bodhilinux.com/w/wiki/">Bodhi Linux - Wiki Home Page</a> <a href="https://www.bodhilinux.com/w/bodhi-linux-how-to/">Bodhi Linux - Wiki Table of Contents</a> <h2>Media &amp; Images</h2> Screenshots should be crisp, clear examples Attempt to have some background for context when showing menus Terminal screenshots may be just that Images should be PNG format and uploaded to the media manager For busier example images, make the image clickable for zoom or otherwise indicate/emphasize important details For additional information regarding <a href="https://www.bodhilinux.com/w/logo-and-colors/">colors and logos</a> <a href="https://www.bodhilinux.com/">Bodhi Linux Home</a> <a href="https://www.bodhilinux.com/w/wiki/">Bodhi Linux - Wiki Home Page</a> <a href="https://www.bodhilinux.com/w/bodhi-linux-how-to/">Bodhi Linux - Wiki Table of Contents</a>