Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[SQIP] Add documentation #5287

Merged
merged 5 commits into from
Jun 12, 2018
Merged

Conversation

axe312ger
Copy link
Collaborator

@axe312ger axe312ger commented May 4, 2018

My working PR for the upcoming SQIP documentation. This is not ready yet, I just prefer pull requests to track my own progress.

Comments are still welcome, ofc :)

Readme preview: https://github.com/axe312ger/gatsby/tree/docs/using-sqip/packages/gatsby-transformer-sqip
Example preview: https://deploy-preview-5287--using-sqip.netlify.com/

@@ -48,6 +48,8 @@ const data = {
},
}

// @todo move all the styles to css file
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

to get a feeling of how the pictures will look like, even{' '}
<strong>before</strong> they got loaded by their (probably) slow
connection.
</p>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

non-jsx example missing here.

Add copyright hint for background image, too

@@ -2,25 +2,144 @@

Generates vectorized primitive version of images to be used as preview thumbnails.


@todo add some example gif
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@todo add example gif


Some research: https://axe312ger.github.io/embedded-svg-loading-impact-research/

@todo image with loading time impact from webpagetest.com
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@todo this whole section is still very incomplete

@gatsbybot
Copy link
Collaborator

gatsbybot commented May 4, 2018

Deploy preview for gatsbygram ready!

Built with commit b89e446

https://deploy-preview-5287--gatsbygram.netlify.com

@gatsbybot
Copy link
Collaborator

gatsbybot commented May 4, 2018

Deploy preview for using-drupal ready!

Built with commit b89e446

https://deploy-preview-5287--using-drupal.netlify.com

@m-allanson
Copy link
Contributor

This looks like it's coming together nicely, it's great to see detailed docs like this :) Drop a note here whenever this is ready for review.

@axe312ger axe312ger changed the title [SQIP] Add documentation - work in progress [SQIP] Add documentation May 31, 2018
@axe312ger
Copy link
Collaborator Author

axe312ger commented May 31, 2018

Especially @m-allanson but for everybody: This is ready for review.

The only missing piece is the example gif for the readme, will follow soon ™️

@KyleAMathews
Copy link
Contributor

Deploy preview for using-glamor failed.

Built with commit 52cfd5c

https://app.netlify.com/sites/using-glamor/deploys/5b0ff73011b73b2d6d8fa4f8

@axe312ger
Copy link
Collaborator Author

@KyleAMathews

3:27:36 PM: error Couldn't find any versions for "gatsby-cli" that matches "^1.1.54"

Same as my local issue as mentioned on discord 🙈

@m-allanson
Copy link
Contributor

Looking 👍!

Is there an invisible character in the Using section? I'm seeing a question mark:

screen shot 2018-05-31 at 21 03 45

Otherwise I think this is ready to go in once the gif is added.

}
```

With `gatsby-transformer-contentful`:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be with gatsby-source-contentful ? :)

@axe312ger
Copy link
Collaborator Author

I guess this is ready for merge or at least some re-reviews :)

@pieh @m-allanson @KyleAMathews

@axe312ger
Copy link
Collaborator Author

If ✅ is given, this should be squash-merged into one commit :)

Copy link
Contributor

@m-allanson m-allanson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👌 excellent docs, thanks :)

@m-allanson m-allanson merged commit fcf765d into gatsbyjs:master Jun 12, 2018
@axe312ger axe312ger deleted the docs/using-sqip branch June 12, 2018 14:59
m-allanson added a commit that referenced this pull request Jun 14, 2018
* master: (26 commits)
  Publish
  [feat] Extract internal plugin for automatically creating pages so we can reuse for other directories (#4490)
  fix(contentful): properly delete deleted entries and assets (#5756)
  Fix typo
  add Linda's post (#5817)
  [gatsby-source-contentful] Fix prepareJSONNode for array normalization (#5107)
  Process Contentful images inlined in markdown (#5542)
  feat(contentful): add traced SVGs to Contentful images (#5659)
  [SQIP] Add documentation (#5287)
  Add site to showcase (#5819)
  [gatsby-remark-copy-linked-files] Support reference-style images (#5818)
  Update docs for gatsby-plugin-catch-links (#5843)
  Added ⋅ representing a space to sub-list examples to reflect actual code (#5829)
  Adding tigerfacilityservices.com to showcase (#5855)
  fix schema type conflict reporter regressions (#5805)
  [gatsby-plugin-feed] Support nested output directory (#5820)
  Make cache available to the plugins (#5840)
  [gatsby-source-contentful] update data and jest snapshots (#5802)
  [gatsby-plugin-manifest] Replace all manifest.json with manifest.webmanifest in comments/docs (#5157)
  Update deploy-gatsby.md (#5800)
  ...

# Conflicts:
#	docs/tutorial/part-one/index.md
#	examples/using-sqip/src/components/polaroid.js
#	packages/gatsby-image/README.md
#	packages/gatsby-image/package.json
#	packages/gatsby-plugin-catch-links/package.json
#	packages/gatsby-plugin-feed/package.json
#	packages/gatsby-plugin-manifest/package.json
#	packages/gatsby-plugin-page-creator/src/gatsby-node.js
#	packages/gatsby-remark-copy-linked-files/package.json
#	packages/gatsby-source-contentful/package.json
#	packages/gatsby-source-contentful/src/__tests__/__snapshots__/normalize.js.snap
#	packages/gatsby-source-contentful/src/extend-node-type.js
#	packages/gatsby-source-contentful/src/gatsby-node.js
#	packages/gatsby-source-contentful/src/normalize.js
#	packages/gatsby-transformer-remark/package.json
#	packages/gatsby-transformer-remark/src/__tests__/__snapshots__/gatsby-node.js.snap
#	packages/gatsby-transformer-sqip/package.json
#	packages/gatsby-transformer-sqip/src/extend-node-type.js
#	packages/gatsby/package.json
#	packages/gatsby/src/bootstrap/load-plugins/__tests__/__snapshots__/load-plugins.js.snap
#	packages/gatsby/src/bootstrap/load-plugins/load.js
#	www/src/data/sites.yml
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants