Skip to content

Refactor data fetching API docs#30615

Merged
timneutkens merged 78 commits into
vercel:canaryfrom
molebox:refactor-data-fetching
Jan 12, 2022
Merged

Refactor data fetching API docs#30615
timneutkens merged 78 commits into
vercel:canaryfrom
molebox:refactor-data-fetching

Conversation

@molebox

@molebox molebox commented Oct 29, 2021 •
edited by balazsorban44
Loading

Copy link
Copy Markdown
Contributor

New PR, same content. Refactor the Data fetching APIs so that they are logically split between API reference and concept info.

Depends on hash redirects PR: https://github.com/vercel/front/pull/11298

Bug

  • Related issues linked using
  • Integration tests added
  • Errors have helpful link attached, see contributing.md

Feature

  • Implements an existing feature request or RFC. Make sure the feature request has been accepted for implementation before opening a PR.
  • Related issues linked using Fixes Refactor Data fetching guide #29603
  • Integration tests added
  • Documentation added
  • Telemetry added. In case of a feature if it's used or not.
  • Errors have helpful link attached, see contributing.md

Documentation / Examples

  • Make sure the linting passes by running yarn lint

leerob
leerob reviewed Oct 30, 2021
View reviewed changes
Comment thread docs/api-reference/data-fetching/getInitialProps.md Outdated
Comment thread docs/basic-features/data-fetching/data-fetching.md Outdated
Comment thread docs/basic-features/data-fetching/data-fetching.md Outdated
Comment thread docs/manifest.json Outdated
Comment thread docs/api-reference/data-fetching/getServerSideProps.md Outdated
@molebox molebox requested a review from leerob November 2, 2021 13:07
@styfle

styfle commented Nov 11, 2021

Copy link
Copy Markdown
Member

Lint is failing because the manifest file needs to be updated

No missing paths in errors/manifest.json
No missing paths in docs/manifest.json
Could not find path: /docs/basic-features/data-fetching.md
Error: missing/incorrect manifest items detected see above
    at main (/home/runner/work/next.js/next.js/scripts/check-manifests.js:61:11)

@molebox

molebox commented Nov 12, 2021

Copy link
Copy Markdown
Contributor Author

Lint is failing because the manifest file needs to be updated

No missing paths in errors/manifest.json
No missing paths in docs/manifest.json
Could not find path: /docs/basic-features/data-fetching.md
Error: missing/incorrect manifest items detected see above
    at main (/home/runner/work/next.js/next.js/scripts/check-manifests.js:61:11)

Should be a'ok now @styfle

leerob
leerob reviewed Nov 15, 2021
View reviewed changes

@leerob leerob left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looking good!

Comment thread docs/api-reference/data-fetching/getInitialProps.md Outdated
Comment thread docs/api-reference/data-fetching/getServerSideProps.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticPaths.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticPaths.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticPaths.md Outdated
Comment thread docs/basic-features/data-fetching/getStaticProps.md Outdated
Comment thread docs/basic-features/data-fetching/getStaticProps.md Outdated
Comment thread docs/basic-features/data-fetching/getStaticProps.md Outdated
Comment thread docs/basic-features/data-fetching/getStaticProps.md Outdated
Comment thread docs/basic-features/data-fetching/swr.md Outdated
leerob
leerob reviewed Nov 16, 2021
View reviewed changes
Comment thread docs/api-reference/data-fetching/getStaticPaths.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticPaths.md Outdated
Nutlope
Nutlope reviewed Nov 16, 2021
View reviewed changes
Comment thread docs/api-reference/data-fetching/getServerSideProps.md Outdated
@molebox molebox requested a review from leerob November 22, 2021 13:48
@molebox

molebox commented Nov 22, 2021

Copy link
Copy Markdown
Contributor Author

Im pretty sure I got all your comments @leerob, please let me know if I missed something 🙏

@molebox molebox requested a review from Nutlope November 22, 2021 14:25
@molebox

molebox commented Nov 29, 2021

Copy link
Copy Markdown
Contributor Author

@leerob coudl you take another look at this please 🙏

leerob
leerob reviewed Nov 29, 2021
View reviewed changes
Comment thread docs/api-reference/data-fetching/getServerSideProps.md Outdated
Comment thread docs/api-reference/data-fetching/getServerSideProps.md Outdated
Comment thread docs/api-reference/data-fetching/getServerSideProps.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticPaths.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticPaths.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticProps.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticProps.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticProps.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticProps.md Outdated
Comment thread docs/api-reference/data-fetching/getStaticProps.md Outdated
@molebox

molebox commented Nov 30, 2021

Copy link
Copy Markdown
Contributor Author

Ok, ive made soem improvements to copy, and added your suggestions (thank you!) Good for another round @leerob 🙏 54th times a charm!

@leerob

leerob commented Nov 30, 2021

Copy link
Copy Markdown
Contributor

I think it's key-value, but we should pick one and add it to the style guide (I'm fine with either).

leerob
leerob reviewed Nov 30, 2021
View reviewed changes
Comment thread docs/api-reference/data-fetching/getStaticProps.md Outdated
leerob
leerob reviewed Nov 30, 2021
View reviewed changes
Comment thread docs/basic-features/data-fetching/getStaticPaths.md Outdated
@molebox

molebox commented Nov 30, 2021

Copy link
Copy Markdown
Contributor Author

Updated heading and the redirect on front @leerob 🚢

leerob
leerob previously approved these changes Nov 30, 2021
View reviewed changes

@leerob leerob left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I believe all my feedback has been addressed. I would love a second or third +1 on this one due to:

  1. The size of the PR
  2. The importance of these docs (They are arguably some of the most important and most used!)

@molebox

molebox commented Nov 30, 2021

Copy link
Copy Markdown
Contributor Author

I believe all my feedback has been addressed. I would love a second or third +1 on this one due to:

  1. The size of the PR

  2. The importance of these docs (They are arguably some of the most important and most used!)

Agreed! Thank you for taking the time to review it all!

@molebox molebox force-pushed the refactor-data-fetching branch from bd21ff8 to b257aa2 Compare December 16, 2021 10:26
@molebox molebox requested a review from timneutkens December 22, 2021 16:41
@timneutkens timneutkens merged commit d291aa9 into vercel:canary Jan 12, 2022
teleaziz added a commit to teleaziz/next.js that referenced this pull request Jan 12, 2022
@teleaziz
Merge branch 'canary' of github.com:vercel/next.js into cms-builder-i…
7c161cf 
…o-example

* 'canary' of github.com:vercel/next.js:
  Added links to data fetching api refs, fixed title (vercel#33221)
  Removed backticks on data fetching api titles (vercel#33216)
  middlewares: limit `process.env` to inferred usage (vercel#33186)
  Fixed broken link (vercel#33209)
  v12.0.8
  v12.0.8-canary.22
  Refactor data fetching API docs (vercel#30615)
  Docs: correct ignorance pattern for .env.local (vercel#32647)
  Fixes vercel#33153: Updating cross-references from master to main + canary (vercel#33198)
  v12.0.8-canary.21
  Add util for normalizing errors (vercel#33159)
  Fix broken yarn pnp (vercel#32867)
@balazsorban44 balazsorban44 mentioned this pull request Jan 15, 2022
Closed
1 task
@vercel vercel locked as resolved and limited conversation to collaborators Feb 11, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

@huozhi huozhi Awaiting requested review from huozhi
@ijjk ijjk Awaiting requested review from ijjk
@padmaia padmaia Awaiting requested review from padmaia
@shuding shuding Awaiting requested review from shuding
@styfle styfle Awaiting requested review from styfle
@Nutlope Nutlope Awaiting requested review from Nutlope
@leerob leerob Awaiting requested review from leerob
@ashleygwilliams ashleygwilliams Awaiting requested review from ashleygwilliams
@steven-tey steven-tey Awaiting requested review from steven-tey
@timneutkens timneutkens Awaiting requested review from timneutkens
1 more reviewer
@balazsorban44 balazsorban44 balazsorban44 approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

examples Issue was opened via the examples template.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Refactor Data fetching guide

8 participants

@molebox @styfle @leerob @balazsorban44 @ashleygwilliams @timneutkens @Nutlope @ijjk