Remove the "Install" section from the "Command-line quick start" guide.

[marten-seemann]

There are two Install guides on docs.ipfs.io: https://docs.ipfs.io/install/command-line-quick-start/ and https://docs.ipfs.io/how-to/command-line-quick-start/. They are slightly different, for example, the latter one instructs Mac users to download the x86 version, which is not supported by current OSX versions any more.

When installing IPFS that way, users will run into problems with OSX Gatekeeper, since the binary is not properly signed. Maybe we should recommend using Homebrew to install IPFS? Otherwise, we might want to add some text how to add an exception for the Gatekeeper.

[johnnymatthews]

There's two issues here:

We have two quick-starts.

Let's delete the quick start under the How-tos section.

• Delete the Quick Start section from How-tos.
• File a PR with the infrastructure team to add a redirect /how-to/command-line-quick-start/ -> /install/command-line-quick-start/
• Remove /how-to/command-line-quick-start/ from the sidebar.

IPFS has issues installing on macOS.

There are several ways around this. Using Homebrew as you suggest, or by grabbing the Go-IPFS binary with wget. Although I believe the binaries at dist.ipfs.io are signed. Would you be able to test this @marten-seemann?

[marten-seemann]

There are several ways around this. Using Homebrew as you suggest, or by grabbing the Go-IPFS binary with wget. Although I believe the binaries at dist.ipfs.io are signed. Would you be able to test this @marten-seemann?

Github and dist.ipfs.io seem to serve the same files. Checking again, it also looks like I only get the Gatekeeper warning for the 32-bit version, not the 64-bits.

[johnnymatthews]

Thanks for checking in on that @marten-seemann. There likely needs to be a discussion around whether or not we should keep the 32-bit version. There's already an internal discussion on how to drop support (seems very simple), we just need to decide whether or not we should. I'll update this issue with more information once it comes out.

[johnnymatthews]

I created an issue to discuss dropping 32-bit macOS support. The result of that discussion was to keep supporting 32-bit macOS, and fix the signing process, which spawned a new issue.

So, the second part of this issue, IPFS has issues installing on macOS, will be fixed by the new ipfs/distributions` issue #273. The first part of this issue, We have two quick-starts, still needs to be addressed.

[alexmmueller]

I am wondering if this is a good issue for me to start contributing? I have a product background and surely have a learning curve in working with github, but would be happy to help here.

[johnnymatthews]

This issue has changed from when it was first created. The Install section of the Command-line quick start is a duplicate of the /install/command-line/ page, so it needs to be removed. However, the rest of the Command-line quick start guide is still useful.

Tasks

• Remove the Install IPFS section from the Command-line quick start guide.
• Add a prerequisites section to the Command-line quick start guide.
  • Instruct users to install Go-IPFS through the command-line if they haven't already.

Feel free to have a go at addressing these issues @alexmmueller. Fork this repository and make a PR against master once you have completed your work. I'll assign this issue to you.

[alexmmueller]

Thank you @johnnymatthews, will do so.

[alexmmueller]

Is there anything left to do for me here, or can the issue be closed?

[johnnymatthews]

Nope, that's everything! Thanks for your contribution @alexmmueller!