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

feat(docs): remove decentralized storage concept doc #2102

Merged
merged 1 commit into from Nov 9, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
Expand Up @@ -42,7 +42,7 @@ web3.storage uses CIDs to make its free, decentralized file storage work, with h

Content addressing is the basis of the peer-to-peer hypermedia protocol IPFS (the InterPlanetary File System), which web3.storage uses to locate files. When web3.storage stores your data on IPFS, it can be retrieved from any IPFS node that has a copy of that data. This can make data transfers more efficient and reduce the load on any single node. As each user fetches a piece of data, they keep a local copy around to help other users who might request it later.

In addition to web3.storage making it easy to get your data onto the content-addressed IPFS network, it also provides long-term persistence for your files using the decentralized Filecoin storage network. The Filecoin network incentivizes participants to provide storage space for files on the network — for more details, see the [concept guide to decentralized storage](/docs/concepts/decentralized-storage/). **By combining IPFS and Filecoin storage into one easy-to-use service, web3.storage makes it simple to store, locate, and retrieve your files on the decentralized web.**
In addition to web3.storage making it easy to get your data onto the content-addressed IPFS network, it also provides long-term persistence for your files using the decentralized Filecoin storage network. The Filecoin network incentivizes participants to provide storage space for files on the network. **By combining IPFS and Filecoin storage into one easy-to-use service, web3.storage makes it simple to store, locate, and retrieve your files on the decentralized web.**

## Summary

Expand Down
73 changes: 0 additions & 73 deletions packages/website/pages/docs/concepts/decentralized-storage.md

This file was deleted.

5 changes: 2 additions & 3 deletions packages/website/pages/docs/concepts/w3link.md
Expand Up @@ -5,7 +5,7 @@ description: An overview of IPFS HTTP Gateways and w3link.

# IPFS HTTP Gateways

web3.storage uses the [InterPlanetary File System (IPFS)](https://ipfs.io) as a key part of its [storage and retrieval infrastructure][concepts-decentralized-storage].
web3.storage uses the [InterPlanetary File System (IPFS)](https://ipfs.io) as a key part of its storage and retrieval infrastructure.

The IPFS network is a peer-to-peer network of computers that share resources to efficiently provide content to anyone that requests it. Computers that join the IPFS network use a protocol called [Bitswap][ipfs-docs-bitswap] to request and supply blocks of data using a hash-based Content Identifier (CID) to uniquely identify each block.

Expand All @@ -19,7 +19,7 @@ For more information about fetching content from gateways, see our [guide to dat

## w3link

Providing a great retrieval experience on the web is a key part of the web3.storage platform, as we work to make [decentralized data storage][concepts-decentralized-storage] the default choice for web3 developers.
Providing a great retrieval experience on the web is a key part of the web3.storage platform, as we work to make content-addressed data storage the default choice for web3 developers.

To further this goal, we created a new HTTP gateway that uses existing public IPFS infrastructure and cloud-native caching strategies to provide a high-performance, CID-based HTTP retrieval solution.

Expand Down Expand Up @@ -95,7 +95,6 @@ https://bafybeid4gwmvbza257a7rx52bheeplwlaogshu4rgse3eaudfkfm7tx2my.ipfs.w3s.lin

This is the preferred style for serving web assets over HTTP gateways, because web browsers provide security isolation on a per-domain basis. Using the subdomain style, every CID gets its own "namespace" for things like cookies and local storage, which isolates things from other web content stored on IPFS.

[concepts-decentralized-storage]: /docs/concepts/decentralized-storage/
[brave-ipfs]: https://brave.com/ipfs-support/
[opera-ipfs]: https://blogs.opera.com/tips-and-tricks/2021/02/opera-crypto-files-for-keeps-ipfs-unstoppable-domains/
[ipfs-docs-cid]: https://docs.ipfs.io/concepts/content-addressing
Expand Down
3 changes: 1 addition & 2 deletions packages/website/pages/docs/examples/image-gallery.md
Expand Up @@ -88,12 +88,11 @@ The `getImageMetadata` function simply requests the `metadata.json` file from an

## Conclusion

The web3.storage service and client library make getting your data onto [decentralized storage][concepts-decentralized-storage] easier than ever. In this guide we saw how to use web3.storage to build a simple image gallery using vanilla JavaScript. We hope that this example will help you build amazing things, and we can't wait to see what you make!
The web3.storage service and client library make getting your data onto IPFS easier than ever. In this guide we saw how to use web3.storage to build a simple image gallery using vanilla JavaScript. We hope that this example will help you build amazing things, and we can't wait to see what you make!

[howto-token]: /docs/how-tos/generate-api-token/
[reference-js-put]: /docs/reference/js-client-library/#store-files
[reference-js-list]: /docs/reference/js-client-library/#list-uploads
[concepts-decentralized-storage]: /docs/concepts/decentralized-storage/
[github-example-repo]: https://github.com/web3-storage/example-image-gallery
[github-storage.js]: https://github.com/web3-storage/example-image-gallery/blob/main/src/js/storage.js
[github-helpers.js]: https://github.com/web3-storage/example-image-gallery/blob/main/src/js/helpers.js
Expand Down
3 changes: 1 addition & 2 deletions packages/website/pages/docs/how-tos/list.md
Expand Up @@ -21,7 +21,7 @@ You can see a list of everything you've uploaded to web3.storage on the [Files p

<Img src={ImgFilesListing} alt="A screenshot of the file listing available when logged in to your account" />

This [Files page][site-files] provides a convenient overview of your stored data, including links to view your files in your browser via an [IPFS gateway][ipfs-docs-gateway] and information about how the data is being stored on the [decentralized storage networks][concepts-decentralized-storage] that web3.storage uses under the hood.
This [Files page][site-files] provides a convenient overview of your stored data, including links to view your files in your browser via an [IPFS gateway][ipfs-docs-gateway] and information about how the data is being stored on the decentralized storage networks that web3.storage uses under the hood.

## Using the web3.storage client

Expand Down Expand Up @@ -87,7 +87,6 @@ Here's an example of fetching the first 10 uploads made on the previous day:
[howto-retrieve]: /docs/how-tos/retrieve/
[howto-query]: /docs/how-tos/query/
[howto-gen-token]: /docs/how-tos/generate-api-token/
[concepts-decentralized-storage]: /docs/concepts/decentralized-storage/
[reference-js-client]: /docs/reference/js-client-library/
[reference-js-constructor]: /docs/reference/js-client-library/#constructor
[reference-js-list]: /docs/reference/js-client-library/#list-uploads
Expand Down
3 changes: 1 addition & 2 deletions packages/website/pages/docs/how-tos/query.md
Expand Up @@ -13,7 +13,7 @@ import golangStatus from '!!raw-loader!../../../assets/code-snippets/how-to/gola

In this how-to guide, you'll learn how to **query web3.storage for information about your files.**

When you [store a file][howto-store] with web3.storage, you receive a [content identifier (CID)][ipfs-docs-cid] that you can use to [retrieve the file][howto-retrieve]. However, this CID can also be used to query the service for more details about _how_ the data is stored on the [decentralized storage networks][concepts-decentralized-storage] that web3.storage uses under the hood.
When you [store a file][howto-store] with web3.storage, you receive a [content identifier (CID)][ipfs-docs-cid] that you can use to [retrieve the file][howto-retrieve]. However, this CID can also be used to query the service for more details about _how_ the data is stored on the decentralized storage networks that web3.storage uses under the hood.

This guide will show you how to use web3.storage's [JavaScript client library][reference-js-client] or [Go client library][reference-go-client] to get information about content stored on the network. To follow along, you'll need the API token from your web3.storage account. If you already have an account and a token, read on. If not, have a look at the [quickstart guide][quickstart] to get up and running in just a few minutes for free.

Expand Down Expand Up @@ -189,7 +189,6 @@ If you haven't yet explored in depth how to store data using web3.storage, check
To learn in greater detail how to fetch your data using the web3.storage client, or directly from IPFS using a gateway or the IPFS command line, see the [how-to guide on retrieval][howto-retrieve].

[quickstart]: /docs/intro/#quickstart
[concepts-decentralized-storage]: /docs/concepts/decentralized-storage/
[howto-store]: /docs/how-tos/store/
[howto-retrieve]: /docs/how-tos/retrieve/
[reference-js-client]: /docs/reference/js-client-library/
Expand Down
3 changes: 1 addition & 2 deletions packages/website/pages/docs/how-tos/store.md
Expand Up @@ -174,7 +174,7 @@ Once your files are ready, uploading is a simple method call on the client objec

<Callout type="warning">
##### IMPORTANT
Deleting files from the web3.storage site's [Files page][site-files] will remove them from the file listing for your account, but that doesn't prevent nodes on the [decentralized storage network][concepts-decentralized-storage] from retaining copies of the data indefinitely. Do not use web3.storage for data that may need to be permanently deleted in the future.
Deleting files from the web3.storage site's [Files page][site-files] will remove them from the file listing for your account, but that doesn't prevent nodes on the decentralized storage network from retaining copies of the data indefinitely. Do not use web3.storage for data that may need to be permanently deleted in the future.
</Callout>

<Tabs groupId="lang">
Expand Down Expand Up @@ -323,7 +323,6 @@ You can also get more information about the status of your data. See the [query
[howto-query]: /docs/how-tos/query/
[howto-car-files]: /docs/how-tos/work-with-car-files/
[howto-list-dir]: /docs/how-tos/list-directory-contents/
[concepts-decentralized-storage]: /docs/concepts/decentralized-storage/
[site-files]: https://web3.storage/account/
[ipfs-docs-cid]: https://docs.ipfs.io/concepts/content-addressing/
[ipfs-docs-cli-quickstart]: https://docs.ipfs.io/how-to/command-line-quick-start/
Expand Down
4 changes: 0 additions & 4 deletions packages/website/pages/docs/nav.json
Expand Up @@ -64,10 +64,6 @@
"name": "Content addressing",
"src": "concepts/content-addressing"
},
{
"name": "Decentralized storage",
"src": "concepts/decentralized-storage"
},
{
"name": "IPFS Gateways",
"src": "concepts/w3link"
Expand Down