.github/PULL_REQUEST_TEMPLATE.md

@@ -4,7 +4,7 @@
 -->
 
 <!--
-  Is this a blog post? Check out the docs at https://www.gatsbyjs.org/contributing/blog-contributions/, and please mention if the blog post is pre-approved
+  Is this a blog post? Check out the docs at https://www.gatsbyjs.com/contributing/blog-contributions/, and please mention if the blog post is pre-approved
   by someone from Gatsby.
 -->
 
@@ -21,7 +21,7 @@
     - Update any references, if relevant. This includes Guides and Gatsby Internals docs.
   - If no docs exist:
     - Create a stub for documentation including bullet points for how to use the feature, code snippets (including from happy path tests), etc.
-  - Tag @gatsbyjs/learning for review, pairing, polishing of the documentation
+  - Tag @gatsbyjs/documentation for review, pairing, polishing of the documentation
 -->
 
 ## Related Issues

CODEOWNERS

@@ -2,9 +2,9 @@
 *                                               @gatsbyjs/core
 
 # All docs must be reviewed by the docs team.
-/docs/                                          @gatsbyjs/learning
-**/README.md                                    @gatsbyjs/learning
-dictionary.txt                                  @gatsbyjs/learning
+/docs/                                          @gatsbyjs/documentation
+**/README.md                                    @gatsbyjs/documentation
+dictionary.txt                                  @gatsbyjs/documentation
 
 # Benchmarks
 /benchmarks/                                    @duffn @pvdz @smthomas

CODE_OF_CONDUCT.md

@@ -1,3 +1,3 @@
 # Gatsby Contributor Covenant Code of Conduct
 
-Please check out the [Code of Conduct](https://www.gatsbyjs.org/contributing/code-of-conduct/) page on the Gatsby site.
+Please check out the [Code of Conduct](https://www.gatsbyjs.com/contributing/code-of-conduct/) page on the Gatsby site.

CONTRIBUTING.md

@@ -1,3 +1,3 @@
 ## How to Contribute
 
-For information related to contributing to Gatsby, please check out the [How to Contribute](https://www.gatsbyjs.org/contributing/how-to-contribute/) section of the documentation at the Gatsby site.
+For information related to contributing to Gatsby, please check out the [How to Contribute](https://www.gatsbyjs.com/contributing/how-to-contribute/) section of the documentation at the Gatsby site.

benchmarks/gabe-csv-markdown/.gitignore

@@ -0,0 +1,71 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Typescript v1 declaration files
+typings/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# dotenv environment variable files
+.env*
+
+# gatsby files
+.cache/
+public
+
+# Mac files
+.DS_Store
+
+# Yarn
+yarn-error.log
+.pnp/
+.pnp.js
+# Yarn Integrity file
+.yarn-integrity
+
+gendata.csv

benchmarks/gabe-markdown/README.md → benchmarks/gabe-csv-markdown/README.md

@@ -1,10 +1,10 @@
-# Markdown Benchmark
+# Baseline Gatsby Benchmark: csv + markdown
 
-This is a baseline benchmark for tracking Markdown performance in the Gabe project.
+This is a baseline benchmark site in the Gabe project.
 
-The site can generate an arbitrary amount of super simple pages. Each page has a small header, a quote, and two small paragraphs of random text. No images, because we want to benchmark Markdown.
+This site in particular tracks Markdown performance when sourcing from a single CSV file.
 
-This uses the local file system plugin, though we might switch to sourcing from csv since that has a more efficient internal representation (fewer `File` nodes).
+The site can generate an arbitrary amount of super simple pages. Each page has a small header, a quote, and two small paragraphs of random text. No images, because we want to benchmark Markdown.
 
 ## Install
 

benchmarks/gabe-csv-markdown/gatsby-browser.js

@@ -0,0 +1 @@
+// empty.

benchmarks/gabe-csv-markdown/gatsby-config.js

@@ -0,0 +1,18 @@
+module.exports = {
+  siteMetadata: {
+    title: `Gatsby CSV Markdown Benchmark for Gabe`,
+    description: "A blog like no other blog",
+    author: "Bob the Blogger",
+  },
+  plugins: [
+    {
+      resolve: `gatsby-source-filesystem`,
+      options: {
+        name: `blurp`,
+        path: __dirname + '/gendata.csv',
+      },
+    },
+    `gatsby-transformer-remark`,
+    `gatsby-transformer-csv`,
+  ],
+}

benchmarks/gabe-csv-markdown/gatsby-node.js

@@ -0,0 +1,65 @@
+const path = require(`path`)
+const { createFilePath } = require(`gatsby-source-filesystem`)
+
+exports.createPages = async ({ graphql, actions }) => {
+  const { createPage } = actions
+  const blogPost = path.resolve(`./src/templates/blog-post.js`)
+
+  const result = await graphql(
+    `
+      {
+        allMarkdownRemark(sort: null) {
+          edges {
+            node {
+              id
+              frontmatter {
+                slug
+                title
+              }
+            }
+          }
+        }
+      }
+    `
+  )
+
+  if (result.errors) {
+    throw result.errors
+  }
+
+  // Create blog posts pages.
+  const posts = result.data.allMarkdownRemark.edges
+
+  posts.forEach((post, index) => {
+    const previous = index === posts.length - 1 ? null : posts[index + 1].node
+    const next = index === 0 ? null : posts[index - 1].node
+
+    createPage({
+      path: post.node.frontmatter.slug,
+      component: blogPost,
+      context: {
+        slug: post.node.frontmatter.slug,
+        id: post.node.id,
+        previous,
+        next,
+      },
+    })
+  })
+}
+
+exports.onCreateNode = ({ node, actions }) => {
+  const { createNode } = actions
+
+  if (node.internal.type === `GendataCsv`) {
+    createNode({
+      id: `${node.id}-MarkdownProxy`,
+      parent: node.id,
+      internal: {
+        type: `MarkdownProxy`,
+        mediaType: "text/markdown",
+        content: node.articleContent,
+        contentDigest: String(Math.random()),
+      },
+    })
+  }
+}

benchmarks/gabe-csv-markdown/gen.js

@@ -0,0 +1,60 @@
+const fs = require("fs")
+const path = require("path")
+const faker = require(`faker`)
+
+console.log("Start of gen")
+
+const N = parseInt(process.env.N, 10) || 100
+const FILE = path.resolve("gendata.csv")
+
+// We may want to tweak this a little but for this purpose we have a CSV with one column; the full page contents
+// We then hand that off to markdown
+
+console.log("Now generating " + N + " articles into", FILE)
+fs.writeFileSync(FILE, "articleContent,a,b,c\n")
+
+function createArticle(n) {
+  const title = faker.lorem.sentence()
+  const desc = faker.lorem.sentence()
+  const slug = faker.helpers.slugify(title).toLowerCase()
+  const date = faker.date.recent(1000).toISOString().slice(0, 10)
+  const tags = faker.random
+    .words(3)
+    .split(` `)
+    .map(w => `"${w}"`)
+    .join(`, `)
+
+  const pageContent = `---
+articleNumber: ${n}
+title: "${title.replace(/"/g, '\\"')}"
+description: "${desc.replace(/"/g, '\\"')}"
+slug: '${slug}'
+date: ${date}
+tags: [${tags}]
+---
+
+# ${title}
+
+> ${desc}
+${faker.lorem.paragraphs(2)}
+  `
+
+  // Note: you can only escape double quotes (by doubling them, not by backslash)
+  //       any other content needs to be wrapped in double quotes and is consumed as-is (including newlines and commas)
+  fs.appendFileSync(
+    FILE,
+
+    '"' + pageContent
+      .trim()
+      .replace(/"/g, '""')
+      + '",1,2,3' +
+      "\n" // markdown does care about newlines
+  )
+}
+
+for (let i = 0; i < N; ++i) {
+  createArticle(i)
+}
+
+console.log("Finished generating " + N + " articles into", FILE)
+console.log("End of gen")

benchmarks/gabe-csv-markdown/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "gabe-csv-markdown",
+  "private": true,
+  "description": "Benchmark site for testing baseline markdown perf when sourcing all pages through one CSV file",
+  "author": "Peter van der Zee <pvdz@github>",
+  "version": "0.1.0",
+  "license": "MIT",
+  "scripts": {
+    "bench": "rm -rf gendata.csv; gatsby clean; N=${N:-512} node gen.js; CI=1 node --max_old_space_size=${M:-2}000 node_modules/.bin/gatsby build",
+    "build": "gatsby build",
+    "clean": "gatsby clean",
+    "develop": "gatsby develop",
+    "format": "prettier --write \"**/*.{js,jsx,json,md}\""
+  },
+  "devDependencies": {
+    "prettier": "2.0.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gatsbyjs/gatsby/tree/master/benchmarks/"
+  },
+  "bugs": {
+    "url": "https://github.com/gatsbyjs/gatsby/issues"
+  },
+  "keywords": [
+    "gatsby",
+    "benchmark",
+    "markdown"
+  ],
+  "dependencies": {
+    "faker": "^4.1.0",
+    "gatsby": "^2",
+    "gatsby-source-filesystem": "^2",
+    "gatsby-transformer-csv": "^2",
+    "gatsby-transformer-remark": "^2",
+    "react": "^16.12.0",
+    "react-dom": "^16.12.0"
+  }
+}

benchmarks/gabe-csv-markdown/src/pages/index.js

@@ -0,0 +1,70 @@
+import React from "react"
+import { Link, graphql } from "gatsby"
+
+import Bio from "../components/bio"
+import Layout from "../components/layout"
+
+class BlogIndex extends React.Component {
+  render() {
+    const { data } = this.props
+    const siteTitle = data.site.siteMetadata.title
+    const posts = data.allMarkdownRemark.edges
+
+    return (
+      <Layout location={this.props.location} title={siteTitle}>
+        <Bio />
+        {posts.map(({ node }) => {
+          const title = node.frontmatter.title || node.frontmatter.slug
+          return (
+            <article key={node.frontmatter.slug}>
+              <header>
+                <h3
+                  style={{
+                    marginBottom: '5px',
+                  }}
+                >
+                  <Link style={{ boxShadow: `none` }} to={'/' + node.frontmatter.slug}>
+                    {title}
+                  </Link>
+                </h3>
+                <small>{node.frontmatter.date}</small>
+              </header>
+              <section>
+                <p
+                  dangerouslySetInnerHTML={{
+                    __html: node.frontmatter.description || node.excerpt,
+                  }}
+                />
+              </section>
+            </article>
+          )
+        })}
+      </Layout>
+    )
+  }
+}
+
+export default BlogIndex
+
+export const pageQuery = graphql`
+  query {
+    site {
+      siteMetadata {
+        title
+      }
+    }
+    allMarkdownRemark(limit: 100) {
+      edges {
+        node {
+          excerpt
+          frontmatter {
+            slug
+            date(formatString: "MMMM DD, YYYY")
+            title
+            description
+          }
+        }
+      }
+    }
+  }
+`