Style Guide

This is the style guide that contributors will use to add content to the project.

Before You Contribute

Markup Formatting

This project uses the GFM for its content formatting. Not familiar with it? Visit http://daringfireball.net/projects/markdown/syntax.

Git Commands

Format

Overall

1. Any place where commands or code is noted, the contributor will use the code format.

Tables

For some information, a table is the preferred format. This is best when you have one-liners or short entries that require no extra sample content. In these cases, a simple table can be used to format the data. The table should have at least 2 columns: Command and Description and may have more if desired/warranted. An example of the Markup formatted table is below.

| Command | Description | OS |
| ------- | ----------- | -- |
| `ls` | Lists the files in the current directory. | *nix |

Detailed Entries

Sometimes the content of a page may require additional details that may not look good in a table view. In this case, we use a Detailed Format as described below.

# Windows Finding File Commands

Commands that find files on the filesystem and are usually executed from the context of the `cmd.exe` or `command.exe` prompt.

## dir
### Attributes Showing
 * **Command with arguments**: `dir /a`
 * **Description**: Displays files with specified attributes. Examples: D=Directories, R=Read-only files, H=Hidden files, A=Files ready for archiving, S=System files
 * **Output**:
   * <div class="slide" style="cursor: pointer;"> **Windows 2008:** Show/Hide</div><div class="view"><code>C:\Users\johndoe>dir /a c:\<br> Volume in drive C has no label. Volume Serial Number is 1A09-5F16<br><br> Directory of c:\<br><br>01/19/2008  03:45 AM    <DIR>          $Recycle.Bin<br>09/18/2006  04:43 PM                24 autoexec.bat<br>10/08/2013  10:27 PM    <DIR>          Boot</code></div> 

Windows Finding File Commands

Commands that find files on the filesystem and are usually executed from the context of the cmd.exe or command.exe prompt.

## Heading
### Subheading Content
 * **Command with arguments**: `dir /a`
 * **Description**: Displays files with specified attributes. Examples: D=Directories, R=Read-only files, H=Hidden files, A=Files ready for archiving, S=System files
 * **Output**:
   * <div class="slide" style="cursor: pointer;"> **Windows 2008:** Show/Hide</div><div class="view"><code>C:\Users\johndoe>dir /a c:\<br> Volume in drive C has no label. Volume Serial Number is 1A09-5F16<br><br> Directory of c:\<br><br>01/19/2008  03:45 AM    <DIR>          $Recycle.Bin<br>09/18/2006  04:43 PM                24 autoexec.bat<br>10/08/2013  10:27 PM    <DIR>          Boot<br>04/11/2009  08:00 AM           333,257 bootmgr<br>10/08/2013  10:27 PM             8,192 BOOTSECT.BAK<br>09/18/2006  04:43 PM                10 config.sys<br>01/19/2008  06:47 AM    <JUNCTION>     Documents and Settings [C:\Users]<br>10/23/2013  07:39 PM     2,460,454,912 pagefile.sys<br>01/19/2008  04:40 AM    <DIR>          PerfLogs<br>10/08/2013  06:36 PM    <DIR>          Program Files<br>10/08/2013  06:36 PM    <DIR> <br>10/10/2013  07:59 PM    <DIR>          Users<br>10/23/2013  07:38 PM    <DIR>          Windows<br>               5 File(s)  2,460,796,395 bytes<br>              10 Dir(s)  33,311,416,320 bytes free</code></div>

Content

Overall

1. Make the entries as descriptive as possible. Remember that a wide audience of people will be reading this content. We are writing so that the novice can understand and the expert find value quickly.
2. Reread your content before submitting a pull request. Ensure that there are no spelling errors and the formatting is correct.
3. Provide URLs or links to other authoritative sites that the reader can visit for more information. We say authoritative so that we use links to quality, sites like Microsoft's Technet for Windows commands instead of "My friend Joe's blog". Try to go to the source when possible.
4. Some pages may need multiple tables such as if you have a multiple commands (wmic, net, and ipconfig) that each have multiple entries. In this case, please create a single table for each of the commands and make them in their own sections such as below:

## net
| Command | Description |
| ------- | ----------- |
| `net view [/domain | /domain:OTHERDOMAINNAME]` | Queries NBNS/SMB (SAMBA) and tries to find all hosts in the system's current workgroup. Add the `/domain` option if the current system is joined to a domain. To query a different domain, use the `/domain:OTHERDOMAINNAME` option. |

## wmic
| Command | Description |
| ------- | ----------- |
| `wmic process get caption,executablepath,commandline` | Retrieves process names, captions, executable paths and command line flags. | 

1. Within a table, sort the rows by the command/first column entries.

Code Format