Clarify and fix grammar for Formats docs#867

Merged

muuki88 merged 73 commits intosbt:masterfrom weedySeaDragon:formats--clarify-and-fix-grammar

Aug 21, 2016

+267-147

Commits on Aug 17, 2016

grammar: replace comma splice with "that"
weedySeaDragon
committed
'dendend' isn't a word; clarified
weedySeaDragon
committed
Sentences about 'settings' should go in their own paragraph. (''...depend... ' sentence doesn't relate to them)
weedySeaDragon
committed
fix grammar; 'because' is stronger and clearer
weedySeaDragon
committed
fix awkard sentence construction; clarify
weedySeaDragon
committed
use 'output' to be in line with the 'Output' section below. (also: 'package' is confusing and ambiguous to new users)
weedySeaDragon
committed
Include the idea that the files generated are in a specific format. (Helps to relate to the 'Output' section below)
weedySeaDragon
committed
Must define "universal packaging" (esp. for newbies). Clarify the intro paragraph a bit more
weedySeaDragon
committed
correct grammar; refer to the plugin in a standardized way
weedySeaDragon
committed
Added sentence to explain the code block
weedySeaDragon
committed
fix capitalization; standardize reference to "mappings" (previous documentation hasn't referred to 'mapping key')
weedySeaDragon
committed
explain the cli options. Add needed blank line between sentences. Add optional comma and colon
weedySeaDragon
committed
clarify by separating the explanation from the example.
weedySeaDragon
committed
clarify 'add build generated' (is unclear to novices); correct 'simple'. "pattern" makes it clear that the example can be generalized
weedySeaDragon
committed
new paragraph: the sentence is a thought important and different enough from the preceding ones.
weedySeaDragon
committed

Commits on Aug 18, 2016

Commits on Aug 19, 2016

Commits on Aug 20, 2016

corrections per review comments: remove AutoPlugin, enought, use :=
weedySeaDragon
committed