Fix copy and links

7 files changed, 107 insertions, 54 deletions

diff --git a/packages/dev-tools-pages/ts/components/compiler.tsx b/packages/dev-tools-pages/ts/components/compiler.tsx
index 694a535dd..c00e3a2b9 100644
--- a/packages/dev-tools-pages/ts/components/compiler.tsx
+++ b/packages/dev-tools-pages/ts/components/compiler.tsx
@@ -45,7 +45,7 @@ const Dd = styled.dd`
 
 const cards = [
     {
-        title: 'A Project-centric',
+        title: 'Project-centric',
         body: (
             <React.Fragment>
                 Compiles an entire project instead of only individual <InlineCode isAlt={true}>.sol</InlineCode> files.
@@ -54,7 +54,7 @@ const cards = [
     },
     {
         title: 'Incremental builds',
-        body: 'Recompiles your smart contracts after they have changed',
+        body: 'Only recompiles smart contracts that have been modified.',
     },
     {
         title: 'Customizable artifacts',
@@ -63,12 +63,16 @@ const cards = [
     },
     {
         title: 'Seamless',
-        body: 'Fetches and caches the required compiler binaries.',
+        body: 'Fetches and caches the required compiler binaries for the Solidity versions you use.',
     },
     {
         title: 'Versioning',
         body:
-            'Compiles each contract with the version specified at the top of its file (sol-compiler even supports version ranges!).',
+            'Compiles each contract with the Solidity version specified at the top of its file (it even supports version ranges!).',
+    },
+    {
+        title: 'Watch mode',
+        body: 'Have your contracts instantly recompile on file save.',
     },
 ];
 
diff --git a/packages/dev-tools-pages/ts/components/hero.tsx b/packages/dev-tools-pages/ts/components/hero.tsx
index 688625730..a024a49dc 100644
--- a/packages/dev-tools-pages/ts/components/hero.tsx
+++ b/packages/dev-tools-pages/ts/components/hero.tsx
@@ -14,7 +14,7 @@ const Hero: React.StatelessComponent<ContextInterface> = ({ children }) => (
                 <HeroContainer>
                     <Subtitle>{subtitle}</Subtitle>
                     <Tagline as="p">{tagline}</Tagline>
-                    <Button as="a" href={docLink} large={true}>
+                    <Button as="a" href={docLink} target="_blank" large={true}>
                         Read the Docs
                     </Button>
                 </HeroContainer>
diff --git a/packages/dev-tools-pages/ts/components/trace.tsx b/packages/dev-tools-pages/ts/components/trace.tsx
index 108154648..96e75013d 100644
--- a/packages/dev-tools-pages/ts/components/trace.tsx
+++ b/packages/dev-tools-pages/ts/components/trace.tsx
@@ -25,7 +25,7 @@ const Trace: React.StatelessComponent<{}> = () => (
                             troublemaking line of code. The only hint you'll get is a generic error.
                         </MainCopy>
                         <Breakout>
-                            <Code isLight={true}>Error: VM Exception while processing transaction: rever</Code>
+                            <Code isLight={true}>Error: VM Exception while processing transaction: revert</Code>
                         </Breakout>
 
                         <List>
@@ -44,8 +44,8 @@ const Trace: React.StatelessComponent<{}> = () => (
                                 <Copy dark={true}>
                                     <Gamma as="h3">Time-consuming</Gamma>
                                     <p>
-                                        Working with a large code-base that contains hundreds of smart contracts,
-                                        finding the failing line of code quickly becomes a daunting task.
+                                        Working within a large code-base that contains many smart contracts, finding the
+                                        failing line of code quickly becomes a daunting task.
                                     </p>
                                 </Copy>
                                 <Icon as={TimeConsuming} />
@@ -78,8 +78,8 @@ const Trace: React.StatelessComponent<{}> = () => (
                                 <Copy>
                                     <Gamma as="h3">Exact location</Gamma>
                                     <p>
-                                        It shows you the exact location of the specific code linen and where it was
-                                        called from.
+                                        It shows you the exact location of the offending line and where it was called
+                                        from.
                                     </p>
                                 </Copy>
                                 <Icon as={ExactLocation} />
@@ -90,8 +90,7 @@ const Trace: React.StatelessComponent<{}> = () => (
                                     <Gamma as="h3">Time-saving</Gamma>
                                     <p>
                                         Turning "Your code failed somewhere, good luck debugging it" into "Your code
-                                        failed on line X of contract Y", it drastically improves the developer
-                                        experience.
+                                        failed on line X of contract Y", drastically improves the developer experience.
                                     </p>
                                 </Copy>
                                 <Icon as={TimeSaving} />
diff --git a/packages/dev-tools-pages/ts/pages/compiler.tsx b/packages/dev-tools-pages/ts/pages/compiler.tsx
index 93a667562..0468fd84f 100644
--- a/packages/dev-tools-pages/ts/pages/compiler.tsx
+++ b/packages/dev-tools-pages/ts/pages/compiler.tsx
@@ -24,6 +24,9 @@ const Animation = Loadable({
     },
 });
 
+const SOLIDITY_INPUT_FORMAT_DOCS =
+    'https://solidity.readthedocs.io/en/v0.4.24/using-the-compiler.html#compiler-input-and-output-json-description';
+
 const Compiler: React.StatelessComponent<{}> = () => (
     <Base context={context}>
         <Hero>
@@ -74,15 +77,19 @@ const Compiler: React.StatelessComponent<{}> = () => (
         <Content dark={true}>
             <ContentBlock main={true} title="Artifacts">
                 <Lead>
-                    Sol compiler uses solidity standard JSON output format for the artifacts. This way, you can define
-                    which parts of the artifact you need.
+                    Sol compiler uses{' '}
+                    <a href={SOLIDITY_INPUT_FORMAT_DOCS} target="_blank">
+                        Solidity standard JSON input format
+                    </a>{' '}
+                    to specify what to include in the generated artifacts. This way, you have complete flexibility on
+                    what is included.
                 </Lead>
             </ContentBlock>
 
             <ContentBlock title="Production">
                 <p>
-                    Sol compiler uses solidity standard JSON output format for the artifacts. This way, you can define
-                    which parts of the artifact you need.
+                    In production, you want to optimize for a small bundle size, so your compiler.json config would
+                    instruct sol-compiler to only output the contract ABI.
                 </p>
                 <Breakout>
                     <Code isLight={true} language="json" isEtc={true}>
@@ -109,8 +116,9 @@ const Compiler: React.StatelessComponent<{}> = () => (
             </ContentBlock>
             <ContentBlock title="Development">
                 <p>
-                    Sometimes you need to use some debuggers or other dev tools and you’ll need more info in the
-                    artifact.
+                    In development, you need to use profiler and other dev tools that require more information from the
+                    artifact. To do this, you can specify that the artifact also contain the bytecode, deployed bytecode
+                    and source maps.
                 </p>
                 <Breakout>
                     <Code isLight={true} language="json" isEtc={true}>
diff --git a/packages/dev-tools-pages/ts/pages/coverage.tsx b/packages/dev-tools-pages/ts/pages/coverage.tsx
index cf759c712..de03d3a9c 100644
--- a/packages/dev-tools-pages/ts/pages/coverage.tsx
+++ b/packages/dev-tools-pages/ts/pages/coverage.tsx
@@ -33,9 +33,9 @@ const Coverage: React.StatelessComponent<{}> = () => (
         <Intro>
             <IntroLead title="Measure your tests">
                 <p>
-                    When it comes to writing smart contracts, testing is one of the most important steps of the process.
-                    In order to quantify the robustness of your Solidity testing suite, you need to measure its code
-                    coverage.
+                    When it comes to writing secure smart contracts, testing is one of the most important steps in the
+                    process. In order to quantify the robustness of your Solidity testing suite, you need to measure its
+                    code coverage.
                 </p>
             </IntroLead>
             <IntroAside>
@@ -69,10 +69,17 @@ const Coverage: React.StatelessComponent<{}> = () => (
             <ContentBlock title="Prerequisites">
                 <List>
                     <ListItem>
-                        Use <a href="#">ganache-cli</a> as a backing node.
+                        Use{' '}
+                        <a href="https://www.npmjs.com/package/ganache-cli" target="_blank">
+                            ganache-cli
+                        </a>{' '}
+                        as a backing node.
                     </ListItem>
                     <ListItem>
-                        Understand and use <a href="#">web3-provider-engine</a>.
+                        Understand and use{' '}
+                        <a href="https://github.com/MetaMask/provider-engine" target="_blank">
+                            web3-provider-engine
+                        </a>.
                     </ListItem>
                 </List>
             </ContentBlock>
@@ -82,11 +89,18 @@ const Coverage: React.StatelessComponent<{}> = () => (
                 </Breakout>
 
                 <p>
-                    Sol-coverage is a subprovider that needs to be prepended to your <a href="#">provider engine</a>.
-                    Depending on your project setup, you will need to use a specific ArtifactAdapter. Sol-coverage ships
-                    with the <InlineCode>SolCompilerArtifactAdapter</InlineCode> for use with{' '}
-                    <a href="#">Sol-compiler</a> and <InlineCode>TruffleArtifactAdapter</InlineCode> for use with the{' '}
-                    <a href="#">Truffle framework</a>. You can also write your own and support any artifact format.
+                    Sol-coverage is a subprovider that needs to be prepended to your{' '}
+                    <a href="https://github.com/MetaMask/provider-engine" target="_blank">
+                        provider engine
+                    </a>. Depending on your project setup, you will need to use a specific ArtifactAdapter. Sol-coverage
+                    ships with the <InlineCode>SolCompilerArtifactAdapter</InlineCode> for use with{' '}
+                    <a href="http://sol-compiler.com" target="_blank">
+                        Sol-compiler
+                    </a>{' '}
+                    and <InlineCode>TruffleArtifactAdapter</InlineCode> for use with the{' '}
+                    <a href="https://truffleframework.com/truffle" target="_blank">
+                        Truffle framework
+                    </a>. You can also write your own and support any artifact format.
                 </p>
 
                 <Tabs>
@@ -118,19 +132,19 @@ const artifactAdapter = new YourCustomArtifactsAdapter(...);`}
                 </Tabs>
                 <p>
                     Now that we have an <InlineCode>artifactAdapter</InlineCode>, we can create a{' '}
-                    <InlineCode>RevertTraceSubprovider</InlineCode> and append it to our provider engine.
+                    <InlineCode>CoverageSubprovider</InlineCode> and append it to our provider engine.
                 </p>
 
                 <Breakout>
                     <Code language="javascript">
                         {`import { ProviderEngine, RpcSubprovider } from 'web3-provider-engine';
-import { RevertTraceSubprovider } from '@0x/sol-coverage';
+import { CoverageSubprovider } from '@0x/sol-coverage';
 
 const defaultFromAddress = "..."; // Some ethereum address with test funds
-const revertTraceSubprovider = new RevertTraceSubprovider(artifactAdapter, defaultFromAddress);
+const coverageSubprovider = new CoverageSubprovider(artifactAdapter, defaultFromAddress);
 
 const providerEngine = new ProviderEngine();
-providerEngine.addProvider(revertTraceSubprovider);
+providerEngine.addProvider(coverageSubprovider);
 providerEngine.addProvider(new RpcSubprovider({rpcUrl: 'http://localhost:8545'}));
 providerEngine.start();`}
                     </Code>
diff --git a/packages/dev-tools-pages/ts/pages/profiler.tsx b/packages/dev-tools-pages/ts/pages/profiler.tsx
index 16ac9088e..feca368ba 100644
--- a/packages/dev-tools-pages/ts/pages/profiler.tsx
+++ b/packages/dev-tools-pages/ts/pages/profiler.tsx
@@ -66,10 +66,17 @@ const Profiler: React.StatelessComponent<{}> = () => (
             <ContentBlock title="Prerequisites">
                 <List>
                     <ListItem>
-                        Use <a href="#">ganache-cli</a> as a backing node.
+                        Use{' '}
+                        <a href="https://www.npmjs.com/package/ganache-cli" target="_blank">
+                            ganache-cli
+                        </a>{' '}
+                        as a backing node.
                     </ListItem>
                     <ListItem>
-                        Understand and use <a href="#">web3-provider-engine</a>.
+                        Understand and use{' '}
+                        <a href="https://github.com/MetaMask/provider-engine" target="_blank">
+                            web3-provider-engine
+                        </a>.
                     </ListItem>
                 </List>
             </ContentBlock>
@@ -79,11 +86,18 @@ const Profiler: React.StatelessComponent<{}> = () => (
                 </Breakout>
 
                 <p>
-                    Sol-trace is a subprovider that needs to be prepended to your <a href="#">provider engine</a>.
-                    Depending on your project setup, you will need to use a specific ArtifactAdapter. Sol-trace ships
-                    with the <InlineCode>SolCompilerArtifactAdapter</InlineCode> for use with{' '}
-                    <a href="#">Sol-compiler</a> and <InlineCode>TruffleArtifactAdapter</InlineCode> for use with the{' '}
-                    <a href="#">Truffle framework</a>. You can also write your own and support any artifact format.
+                    Sol-trace is a subprovider that needs to be prepended to your{' '}
+                    <a href="https://github.com/MetaMask/provider-engine" target="_blank">
+                        provider engine
+                    </a>. Depending on your project setup, you will need to use a specific ArtifactAdapter. Sol-trace
+                    ships with the <InlineCode>SolCompilerArtifactAdapter</InlineCode> for use with{' '}
+                    <a href="http://sol-compiler.com" target="_blank">
+                        Sol-compiler
+                    </a>{' '}
+                    and <InlineCode>TruffleArtifactAdapter</InlineCode> for use with the{' '}
+                    <a href="https://truffleframework.com/truffle" target="_blank">
+                        Truffle framework
+                    </a>. You can also write your own and support any artifact format.
                 </p>
 
                 <Tabs>
@@ -115,19 +129,19 @@ const artifactAdapter = new YourCustomArtifactsAdapter(...);`}
                 </Tabs>
                 <p>
                     Now that we have an <InlineCode>artifactAdapter</InlineCode>, we can create a{' '}
-                    <InlineCode>RevertTraceSubprovider</InlineCode> and append it to our provider engine.
+                    <InlineCode>ProfilerSubprovider</InlineCode> and append it to our provider engine.
                 </p>
 
                 <Breakout>
                     <Code language="javascript">
                         {`import { ProviderEngine, RpcSubprovider } from 'web3-provider-engine';
-import { RevertTraceSubprovider } from '@0x/sol-coverage';
+import { ProfilerSubprovider } from '@0x/sol-coverage';
 
 const defaultFromAddress = "..."; // Some ethereum address with test funds
-const revertTraceSubprovider = new RevertTraceSubprovider(artifactAdapter, defaultFromAddress);
+const profilerSubprovider = new ProfilerSubprovider(artifactAdapter, defaultFromAddress);
 
 const providerEngine = new ProviderEngine();
-providerEngine.addProvider(revertTraceSubprovider);
+providerEngine.addProvider(profilerSubprovider);
 providerEngine.addProvider(new RpcSubprovider({rpcUrl: 'http://localhost:8545'}));
 providerEngine.start();`}
                     </Code>
diff --git a/packages/dev-tools-pages/ts/pages/trace.tsx b/packages/dev-tools-pages/ts/pages/trace.tsx
index cc34e0fbe..1fa159461 100644
--- a/packages/dev-tools-pages/ts/pages/trace.tsx
+++ b/packages/dev-tools-pages/ts/pages/trace.tsx
@@ -36,10 +36,17 @@ const Trace: React.StatelessComponent<{}> = () => (
             <ContentBlock title="Prerequisites">
                 <List>
                     <ListItem>
-                        Use <a href="#">ganache-cli</a> as a backing node.
+                        Use{' '}
+                        <a href="https://www.npmjs.com/package/ganache-cli" target="_blank">
+                            ganache-cli
+                        </a>{' '}
+                        as a backing node.
                     </ListItem>
                     <ListItem>
-                        Understand and use <a href="#">web3-provider-engine</a>.
+                        Understand and use{' '}
+                        <a href="https://github.com/MetaMask/provider-engine" target="_blank">
+                            web3-provider-engine
+                        </a>.
                     </ListItem>
                 </List>
             </ContentBlock>
@@ -49,11 +56,18 @@ const Trace: React.StatelessComponent<{}> = () => (
                 </Breakout>
 
                 <p>
-                    Sol-trace is a subprovider that needs to be prepended to your <a href="#">provider engine</a>.
-                    Depending on your project setup, you will need to use a specific ArtifactAdapter. Sol-trace ships
-                    with the <InlineCode>SolCompilerArtifactAdapter</InlineCode> for use with{' '}
-                    <a href="#">Sol-compiler</a> and <InlineCode>TruffleArtifactAdapter</InlineCode> for use with the{' '}
-                    <a href="#">Truffle framework</a>. You can also write your own and support any artifact format.
+                    Sol-trace is a subprovider that needs to be prepended to your{' '}
+                    <a href="https://github.com/MetaMask/provider-engine" target="_blank">
+                        provider engine
+                    </a>. Depending on your project setup, you will need to use a specific ArtifactAdapter. Sol-trace
+                    ships with the <InlineCode>SolCompilerArtifactAdapter</InlineCode> for use with{' '}
+                    <a href="http://sol-compiler.com" target="_blank">
+                        Sol-compiler
+                    </a>{' '}
+                    and <InlineCode>TruffleArtifactAdapter</InlineCode> for use with the{' '}
+                    <a href="https://truffleframework.com/truffle" target="_blank">
+                        Truffle framework
+                    </a>. You can also write your own and support any artifact format.
                 </p>
 
                 <Tabs>
@@ -85,19 +99,19 @@ const artifactAdapter = new YourCustomArtifactsAdapter(...);`}
                 </Tabs>
                 <p>
                     Now that we have an <InlineCode>artifactAdapter</InlineCode>, we can create a{' '}
-                    <InlineCode>RevertTraceSubprovider</InlineCode> and append it to our provider engine.
+                    <InlineCode>TraceSubprovider</InlineCode> and append it to our provider engine.
                 </p>
 
                 <Breakout>
                     <Code language="javascript">
                         {`import { ProviderEngine, RpcSubprovider } from 'web3-provider-engine';
-import { RevertTraceSubprovider } from '@0x/sol-coverage';
+import { TraceSubprovider } from '@0x/sol-coverage';
 
 const defaultFromAddress = "..."; // Some ethereum address with test funds
-const revertTraceSubprovider = new RevertTraceSubprovider(artifactAdapter, defaultFromAddress);
+const traceSubprovider = new TraceSubprovider(artifactAdapter, defaultFromAddress);
 
 const providerEngine = new ProviderEngine();
-providerEngine.addProvider(revertTraceSubprovider);
+providerEngine.addProvider(traceSubprovider);
 providerEngine.addProvider(new RpcSubprovider({rpcUrl: 'http://localhost:8545'}));
 providerEngine.start();`}
                     </Code>