Skip to content
This repository has been archived by the owner on Apr 16, 2021. It is now read-only.

Added in a dist blog post draft #21 #23

Merged
merged 16 commits into from
May 30, 2016
Binary file added src/6-distributions/img/screenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
64 changes: 64 additions & 0 deletions src/6-distributions/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
---
date: 2016-01-29
id: 6-distributions
template: tmpl/layouts/post.html
baseurl: ..
breadcrumbs:
- {name: "6-distributions", link: "./" }
tags: dist, distributions
title: IPFS distributions
author: Richard Littauer
collection: posts
---

[![](!img/screenshot.png)](http://dist.ipfs.io/)
Copy link
Contributor

Choose a reason for hiding this comment

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

we have https now


[dist.ipfs.io](http://dist.ipfs.io/) is the new distributions page for IPFS. This is the new one-stop-shop for finding and downloading all official binaries that IPFS produces.
Copy link
Contributor

Choose a reason for hiding this comment

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

"all official binaries that the IPFS Team produces."
or
"all official binaries of the IPFS Project."


Copy link
Contributor

Choose a reason for hiding this comment

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

This is missing a section, before Project Details, explaining how this website itself works. The really cool thing about this site is that everything is shipped with ipfs itself, the site uses dnslink, etc. Users can view the site in their local gateways just fine, too: /ipns/dist.ipfs.io. This means a bunch of things, like: dist.ipfs.io can be replicated and used to distribute ipfs in networks not connected to the internet.

Copy link
Contributor

Choose a reason for hiding this comment

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

And this will add an exciting! flavor to the post.

Copy link
Contributor

Choose a reason for hiding this comment

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

Also it make the distribution page be under HTTPS.

Choose a reason for hiding this comment

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

It's not available under https yet :( // cc @lgierth

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I had a site section, but removed it because I don't understand how the hashes work over time. See this comment: #23 (comment)

Copy link
Contributor

Choose a reason for hiding this comment

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

If you promote it as https://ipfs.io/ipns/dist.ipfs.io then it is under HTTPS.

## Project details

Every distribution has a section, which includes:

- The distribution name and a short description;
- The current version number and release date;
- A download button that detects your platform and automatically suggests the appropriate distribution for you;
- A grid with download links for all supported platforms (operating system and architectures);
- A `Changelog`, a link to a summary of all version changes;
- An `All Versions`, a link to view and download previous versions.

The `All Versions` link on each distribution shows directory listings for all the available versions, and a `versions` file ([example](http://dist.ipfs.io/go-ipfs/versions)). This file can be used by tools, such as [ipfs-update](http://dist.ipfs.io/#ipfs-update), to find all the available versions and download the latest.

The directory listing of each version ([example](http://dist.ipfs.io/go-ipfs/v0.3.11)) has all the platform archives (`.zip` or `.tar.gz`), a `README.md` and a `dist.json` which describe the release for humans and machines. It is meant to be easily consumed and used by tools.

## The Site

The site itself is, unsurprisingly but still awesomely, hosted on IPFS. All of the binaries are also hosted on IPFS. This means that you can view it through your local gateway by running an IPFS daemon and directing your browser to __include address here__. Accessing it locally means that downloading versions (__ Of the site? Or of the distros?__) will be faster in the future. You can also view it with browser extensions, __this way__.

Choose a reason for hiding this comment

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

Still need to resolve those comments of yours

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Do you have answers to those questions?

Choose a reason for hiding this comment

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

  • I would leave out that local version, as the hash changes over time and we will be left with an outdated version soon.
  • No idea how the browser extensions work, is this needed?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Removed the whole section.


The site is also used directly by [`ipfs-update`](https://github.com/ipfs/ipfs-update) to update IPFS.

## Project Prerequisites

In order to be added to the distributions page, a product must:

- Originate from the IFPS community;
- Have high-quality UX and documentation;
- Be well maintained and active.

If you think that a product should be there that isn't, get in touch.

## Future Plans

In the future, we hope to:

- Enable code signing, for progress on this subject you can check this [PR]( https://github.com/ipfs/distributions/pull/51).
- Enable closer integration with package managers.
- Add more products, like [`ipget`](https://github.com/noffle/ipget) (already in the works).

Choose a reason for hiding this comment

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

This is already done

- Host more screenshots of the tools directly in the Distributions page.

Choose a reason for hiding this comment

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

Screenshots, gifs and asciinemas

- Import binaries more intelligently in order to enhance change of deduplication.
- Add the software license (usually MIT) to each distribution.

## Contribute

We welcome any and all sorts of contributions! File issues or send us patches at [ipfs/distributions](https://github.com/ipfs/distributions).

Last but not least, a huge thank you to [Friedel](https://github.com/dignifiedquire) for his amazing work with the Dist page. None of this would be possible without him.

Choose a reason for hiding this comment

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

❤️

Copy link
Contributor

Choose a reason for hiding this comment

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

We should be consistent with everything else and use either: