chore(docs): docs cleanup

chore(docs): change chmod markdown files

chore(docs): update gitignore

.gitignore

@@ -12,7 +12,6 @@ npm-debug.log
 /docs/.cache/
 /docs/node_modules/
 /man/
-/doc/*/npm-index.md
 /npmrc
 /release/
 /npm-*.tgz
@@ -25,3 +24,4 @@ npm-debug.log
 .nyc_output
 /test/npm_cache*
 /node_modules/.cache
+.DS_Store

docs/content/cli-commands/npm-install.md

@@ -38,7 +38,7 @@ A `package` is:
 * a) a folder containing a program described by a [`package.json`](/configuring-npm/package-json) file
 * b) a gzipped tarball containing (a)
 * c) a url that resolves to (b)
-* d) a `<name>@<version>` that is published on the registry (see [`npm-registry`](/using-npm/registry)) with (c)
+* d) a `<name>@<version>` that is published on the registry (see [`registry`](/using-npm/registry)) with (c)
 * e) a `<name>@<tag>` (see [`npm dist-tag`](/cli-commands/npm-dist-tag)) that points to (d)
 * f) a `<name>` that has a "latest" tag satisfying (e)
 * g) a `<git remote url>` that resolves to (a)

docs/content/configuring-npm/package-json.md

@@ -30,7 +30,7 @@ Some rules:
 
 * The name must be less than or equal to 214 characters. This includes the scope for
   scoped packages.
-* The name can't start with a dot or an underscore.
+* The names of scoped packages can begin with a dot or an underscore. This is not permitted without a scope.
 * New packages must not have uppercase letters in the name.
 * The name ends up being part of a URL, an argument on the command line, and a
   folder name. Therefore, the name can't contain any non-URL-safe characters.

docs/src/components/scripts.js

@@ -3,12 +3,12 @@ import React from 'react'
 const IS_STATIC = process.env.GATSBY_IS_STATIC
 
 const Scripts = () => {
+  // Workaround: Make links work on the static html site
   if (IS_STATIC) {
     return (
       <script
         dangerouslySetInnerHTML={{
           __html: `
-          // Workaround: Make links on our Markdown files work on the static site
           var anchors = document.querySelectorAll(".sidebar a, .documentation a")
           Array.prototype.slice.call(anchors).map(function(el) {
             if (el.href.match(/file:\\/\\//)) {