Skip to content
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.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ newIssueWelcomeComment: >
- "Status" labels will show if this is ready to be worked on, blocked, or in progress.
- "Need" labels will indicate if additional input or analysis is required.

Finally, remember to use https://discuss.ipfs.io if you just need general support.
Finally, remember to use https://discuss.ipfs.tech if you just need general support.

# Configuration for new-pr-welcome - https://github.com/behaviorbot/new-pr-welcome
# Comment to be posted to on PRs from first time contributors in your repository
Expand Down
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,7 @@ You can learn more about [pull requests on GitHub](https://help.github.com/en/gi

### Discuss

You can also contribute to the project without specifically writing content for the site. Many discussions are happening all around the project. Protocol Labs, and by extension, IPFS, is a collaborative company that relies heavily on the community. We need your opinions and input! If you have an idea about a topic or want to weigh in on a discussion, feel free to have your say either on [GitHub](https://github.com/ipfs/ipfs-docs/issues) or on the [IPFS forums](https://discuss.ipfs.io/).
You can also contribute to the project without specifically writing content for the site. Many discussions are happening all around the project. Protocol Labs, and by extension, IPFS, is a collaborative company that relies heavily on the community. We need your opinions and input! If you have an idea about a topic or want to weigh in on a discussion, feel free to have your say either on [GitHub](https://github.com/ipfs/ipfs-docs/issues) or on the [IPFS forums](https://discuss.ipfs.tech/).

## Tools

Expand Down Expand Up @@ -143,4 +143,4 @@ This app helps to simplify your writing. It's easy to ramble on while writing, w

## Just Ask

After all that, if you're still not sure how to contribute to this project just post a question on the [IPFS forum](https://discuss.ipfs.io/), or join us on IRC at `#ipfs`.
After all that, if you're still not sure how to contribute to this project just post a question on the [IPFS forum](https://discuss.ipfs.tech/), or join us on IRC at `#ipfs`.
4 changes: 2 additions & 2 deletions docs/.vuepress/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -284,12 +284,12 @@ module.exports = {
'IPFS newsletter'
],
'/community/contribute/ways-to-contribute',
['https://discuss.ipfs.io/', 'IPFS forums'],
['https://discuss.ipfs.tech/', 'IPFS forums'],
'/community/chat',
['https://proto.school/events', 'ProtoSchool workshops'],
['https://www.meetup.com/members/249142444/', 'Meetups'],
'/community/social-media',
['https://awesome.ipfs.io', 'Awesome IPFS'],
['https://awesome.ipfs.tech', 'Awesome IPFS'],
[
'https://www.youtube.com/channel/UCdjsUXJ3QawK4O5L1kqqsew',
'YouTube'
Expand Down
2 changes: 1 addition & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,6 @@ Are you looking for inspiration? You can find a huge collection of awesome commu

## Be part of the IPFS community

IPFS has a bustling community of designers, developers, writers, and activists who are all helping to improve the project. You can join in by attending a local meetup, helping out at a conference, chatting online through [Discord](https://discord.com/invite/KKucsCpZmY), or joining a discussion in [the IPFS forum](https://discuss.ipfs.io/).
IPFS has a bustling community of designers, developers, writers, and activists who are all helping to improve the project. You can join in by attending a local meetup, helping out at a conference, chatting online through [Discord](https://discord.com/invite/KKucsCpZmY), or joining a discussion in [the IPFS forum](https://discuss.ipfs.tech/).

[Find out more in the Community section →](community/README.md)
2 changes: 1 addition & 1 deletion docs/community/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ No matter your area of specialty or level of expertise, there are many [ways to

## IPFS forums

The official [IPFS forums](https://discuss.ipfs.io/) are the primary home of IPFS-related discussion. Join the conversation on [https://discuss.ipfs.io](https://discuss.ipfs.io) for everything from technical questions, project brainstorming, talk on IPFS use cases, and more.
The official [IPFS forums](https://discuss.ipfs.tech/) are the primary home of IPFS-related discussion. Join the conversation on [https://discuss.ipfs.tech](https://discuss.ipfs.tech) for everything from technical questions, project brainstorming, talk on IPFS use cases, and more.

## Chat

Expand Down
2 changes: 1 addition & 1 deletion docs/community/chat.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,4 +21,4 @@ Join [Filecoin slack](https://filecoin.io/slack) and join the bridged #ipfs chan

## Forums

For longer-lived discussions and for support, please use the discussion forums at [https://discuss.ipfs.io](https://discuss.ipfs.io) instead! It’s easy for complex discussions to get lost in a sea of new messages on chat, and posting longer discussions and support requests on the forums help future visitors, too.
For longer-lived discussions and for support, please use the discussion forums at [https://discuss.ipfs.tech](https://discuss.ipfs.tech) instead! It’s easy for complex discussions to get lost in a sea of new messages on chat, and posting longer discussions and support requests on the forums help future visitors, too.
4 changes: 2 additions & 2 deletions docs/community/contribute/ways-to-contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ If you have never contributed to an open-source project before or just need a re

IPFS already has lots of users and curious people experimenting and using IPFS in their applications. These users sometimes get stuck or have questions that need answering. If you've contributed something with code or documentation, the chances are that you can probably help a lot of people with their questions.

The [IPFS forum](https://discuss.ipfs.io/) is the best place to go if you're looking for support.
The [IPFS forum](https://discuss.ipfs.tech/) is the best place to go if you're looking for support.

## Testing

Expand Down Expand Up @@ -74,7 +74,7 @@ Get started by looking at our awesome-ipfs list. Build anything you think is mis
- [ipfs/awesome-ipfs](https://github.com/ipfs/awesome-ipfs)
- [ipfs/notes](https://github.com/ipfs/notes)
- [ipfs/apps](https://github.com/ipfs/apps)
- [IPFS forum](https://discuss.ipfs.io/)
- [IPFS forum](https://discuss.ipfs.tech/)

## Protocol Design

Expand Down
3 changes: 1 addition & 2 deletions docs/concepts/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,6 @@ Get inspired by usage ideas, explore examples of IPFS implemented in the wild, a
- [Case study: Fleek](case-study-fleek.md)
- [Case study: LikeCoin](case-study-likecoin.md)
- [Case study: Morpheus.Network](case-study-morpheus.md)
- [Case study: OpenBazaar](case-study-openbazaar.md)

## Content-addressed storage

Expand Down Expand Up @@ -82,4 +81,4 @@ Want a more in-depth look into the decentralized web? Here are a few papers that

## Don't see what you're looking for?

We're adding more documentation all the time and making ongoing revisions to existing docs, but if you don't see what you need, please [file an issue](https://github.com/ipfs/ipfs-docs/issues/new?assignees=&labels=OKR+3%3A+Content+Improvement%2C+docs-ipfs&template=content-request.md&title=%5BCONTENT+REQUEST%5D+%28add+your+title+here%21%29) to let us know! We also recommend visiting the [IPFS forums](https://discuss.ipfs.io/) for support and discussion with IPFS enthusiasts and experts worldwide.
We're adding more documentation all the time and making ongoing revisions to existing docs, but if you don't see what you need, please [file an issue](https://github.com/ipfs/ipfs-docs/issues/new?assignees=&labels=OKR+3%3A+Content+Improvement%2C+docs-ipfs&template=content-request.md&title=%5BCONTENT+REQUEST%5D+%28add+your+title+here%21%29) to let us know! We also recommend visiting the [IPFS forums](https://discuss.ipfs.tech/) for support and discussion with IPFS enthusiasts and experts worldwide.
2 changes: 1 addition & 1 deletion docs/concepts/case-study-audius.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ Users control their own Ethereum private keys, which permission control of their

One other key ingredient in Audius' decision to initially adopt IPFS was its separation from Filecoin. The Audius team was able to get started using IPFS and hosting on a network of community-operated nodes, without concern for hosting costs. Over time, they are looking forward to having Filecoin-supported nodes so that they can separate their core content business from the hosting aspects of the business. Meanwhile, their current storage network of community-operated creator nodes does offer a high level of flexibility in terms of customization. "The node itself is very customizable," Nagaraj says. "We’ve taken advantage of that. I think we’ve used the node in every way possible."

As a large user of the IPFS network, Audius has taken advantage of the [official IPFS forums](https://discuss.ipfs.io), as well as support provided directly from the core IPFS development team. They are particularly impressed with the level of support and third-party tools that are available on IPFS.
As a large user of the IPFS network, Audius has taken advantage of the [official IPFS forums](https://discuss.ipfs.tech), as well as support provided directly from the core IPFS development team. They are particularly impressed with the level of support and third-party tools that are available on IPFS.

"We think about the IPFS and Filecoin community as a great role model for what we are doing with the community around Audius, in terms of activity and robustness," says Nagaraj. "There are a lot of developers who are constantly contributing to IPFS. A few post on websites like [simpleaswater.com](http://www.simpleaswater.com) with tons of examples of what you can do with IPFS, how to actually implement it, breaking down all the details. We would aim for something like that. It would be incredible for us if we could reach that level of community participation." Nagaraj also calls out as particularly helpful blog posts and other content created by third-party contributors to the codebase, as well as the ecosystem that is developing around IPFS collaborators such as [Textile](http://textile.io/) and [Pinata](https://pinata.cloud/). Having such an active community around an open-source project adds to the momentum and progress of IPFS as a whole.

Expand Down
8 changes: 5 additions & 3 deletions docs/concepts/content-addressing.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Content addressing
title: Content addressing and CIDs
description: Learn about how content addressing works and how content identifiers, or CIDs, play a crucial role in IPFS.
---

Expand All @@ -11,16 +11,18 @@ For a deep dive into how Content Identifiers (CIDs) are constructed, take a look

[[toc]]

## What is a CID?

A _content identifier_, or CID, is a label used to point to material in IPFS. It doesn't indicate _where_ the content is stored, but it forms a kind of address based on the content itself. CIDs are short, regardless of the size of their underlying content.

CIDs are based on the content’s [cryptographic hash](hashing.md). That means:

- Any difference in the content will produce a different CID and
- The same content added to two different IPFS nodes using the same settings will produce _the same CID_.

IPFS uses the `sha-256` hashing algorithm by default, but there is support for many other algorithms. The [Multihash](https://multiformats.io/multihash/) project represents the work for this, with the aim of future-proofing applications' use of hashes and allowing multiple hash functions to coexist. (If you're curious about how hash types in IPFS are decided upon, you may wish to keep an eye on [this forum discussion](https://discuss.ipfs.io/t/who-decides-what-hashing-algorithms-ipfs-allows/6742).)
IPFS uses the `sha-256` hashing algorithm by default, but there is support for many other algorithms. The [Multihash](https://multiformats.io/multihash/) project represents the work for this, with the aim of future-proofing applications' use of hashes and allowing multiple hash functions to coexist. (If you're curious about how hash types in IPFS are decided upon, you may wish to keep an eye on [this forum discussion](https://discuss.ipfs.tech/t/who-decides-what-hashing-algorithms-ipfs-allows/6742).)

## Identifier formats
## CID versions

CIDs can take a few different forms with different encoding bases or CID versions. Many of the existing IPFS tools still generate v0 CIDs, although the `files` ([Mutable File System](file-systems.md#mutable-file-system-mfs)) and `object` operations now use CIDv1 by default.

Expand Down
4 changes: 2 additions & 2 deletions docs/concepts/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Filecoin and IPFS are two separate, complementary protocols, both created by Pro

In short: IPFS addresses and moves content, while Filecoin is an incentive layer to persist data.

These components are separable - you can use one without the other, and IPFS already supports more self-organized or altruistic forms of data persistence via tools like [IPFS Cluster](https://cluster.ipfs.io/). Compatibility between IPFS and Filecoin is intended to be as seamless as possible, but we expect it to evolve. You can view the [draft spec for IPFS-Filecoin Interoperability](https://github.com/filecoin-project/specs/issues/143) and [ideas for future improvements](https://github.com/filecoin-project/specs/issues/144) to learn more.
These components are separable - you can use one without the other, and IPFS already supports more self-organized or altruistic forms of data persistence via tools like [IPFS Cluster](https://ipfscluster.io/). Compatibility between IPFS and Filecoin is intended to be as seamless as possible, but we expect it to evolve. You can view the [draft spec for IPFS-Filecoin Interoperability](https://github.com/filecoin-project/specs/issues/143) and [ideas for future improvements](https://github.com/filecoin-project/specs/issues/144) to learn more.

## IPFS and Protocol Labs

Expand All @@ -52,4 +52,4 @@ IPFS is an open-source project with a community of more than four thousand contr

## Don't see your question?

We're working on expanding this FAQ with more content, including questions from the original-generation [IPFS forums](https://discuss.ipfs.io/c/help/old-faq/5), so please watch this space! However, if you don't see your question, please [ask in the forums](https://discuss.ipfs.io/), so you can get the answers you need and make us aware of new FAQ items.
We're working on expanding this FAQ with more content, including questions from the original-generation [IPFS forums](https://discuss.ipfs.tech/c/help/old-faq/5), so please watch this space! However, if you don't see your question, please [ask in the forums](https://discuss.ipfs.tech/), so you can get the answers you need and make us aware of new FAQ items.
2 changes: 1 addition & 1 deletion docs/concepts/libp2p.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ libp2p's superpower is its modularity. Learn more in ProtoSchool's [Introduction

A [peer-to-peer network](https://docs.libp2p.io/reference/glossary/#peer-to-peer-p2p) is one in which the players, known as _"peers"_, communicate with each other directly as equal participants. This is in direct contrast to the traditional [client-server model](https://docs.libp2p.io/reference/glossary/#client-server), where a privileged central server may provide services to many client programs on the network. These client programs usually do not communicate with each other; they communicate only with the central server.

Someone using Libp2p for the network layer of their peer-to-peer application is instantly freed up to focus on their own unique tasks, knowing that Libp2p handles a lot of [tasks in a decentralized system](https://hub.packtpub.com/libp2p-the-modular-p2p-network-stack-by-ipfs-for-better-decentralized-computing/). At the same time, they can customize Libp2p regarding key elements like transport, identity, and security. Some applications using Libp2p are [Filecoin](https://filecoin.io/), [Parity](https://www.parity.io/why-libp2p/), and [OpenBazaar](https://www.openbazaar.org/).
Someone using Libp2p for the network layer of their peer-to-peer application is instantly freed up to focus on their own unique tasks, knowing that Libp2p handles a lot of [tasks in a decentralized system](https://hub.packtpub.com/libp2p-the-modular-p2p-network-stack-by-ipfs-for-better-decentralized-computing/). At the same time, they can customize Libp2p regarding key elements like transport, identity, and security. Some applications using Libp2p are [Filecoin](https://filecoin.io/), and [Parity](https://www.parity.io/why-libp2p/).

### Features of Libp2p

Expand Down
2 changes: 1 addition & 1 deletion docs/concepts/privacy-and-encryption.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ While a long string of letters and numbers may not be a "Johnny Appleseed" level

## Enhancing your privacy

If there are situations in which you know you'll need to remain private but still want to use IPFS, one of the approaches outlined below may help. And don't forget, you can always discuss privacy and get others' input or ideas in the official [IPFS forums](https://discuss.ipfs.io).
If there are situations in which you know you'll need to remain private but still want to use IPFS, one of the approaches outlined below may help. And don't forget, you can always discuss privacy and get others' input or ideas in the official [IPFS forums](https://discuss.ipfs.tech).

### Controlling what you share

Expand Down
Loading