Content Enhancement: Top Topics that Need Better Documentation

[flyingzumwalt]

We get a constant stream of questions about certain topics -- in emails, Github Issues, conversations on IRC, face-to-face exchanges, etc. This is a sign that we need to do a better job of documenting these topics, putting answers in the places where people will find them, and providing ways to follow ongoing work in these areas.

Topics to Document

We should check each of these off when the volume of queries about the topic drops near zero, which will be a sign that either people are finding answers elsewhere or the topic is no longer important.

• Deleting Content You've Added to IPFS -- especially Right to Be Forgotten - see ipfs/blog#112
• Private Content -- limiting who can read/decrypt the stuff you've published on the IPFS network - see ipfs/blog#115
• Private Networks -- limiting which nodes/peers you will even talk to. This limits which peers can see what you've added to your IPFS node and limits which nodes you will provide blocks to - see ipfs/blog#114
• Making content Persist on the Network -- How to get the content to stay on the IPFS network after your machine disconnects - see ipfs/blog#113

If you can think of any other under-documented topics, please say so in the comments on this issue.

Things we can Do to Address This

Some things we must to in order to reduce the volume of queries:

• Establish clear documentation to address the topic
• Publish links to that documentation places where people are looking
• Provide inroads for people to engage in, or follow, ongoing design/development efforts
• Gather ideas from the community about other ways to answer these questions or other channels for broadcasting the answers

[flyingzumwalt]

Please help gather links to the existing info on these topics -- in comments on this issue please add links to existing Github Issues, papers, API docs, Milestones, etc. so we can figure out the best way to present a list of resources and recommended reading.

[lidel]

Some discussions about Deleting Content You've Added to IPFS:

• editing/deletion of content and power dynamics: editing/deletion of content and power dynamics faq#156
• Can I delete my content from the network? Can I delete my content from the network? faq#9
• editing/deletion of content by another PC editing/deletion of content by another PC faq#169
• https://www.reddit.com/r/ipfs/comments/57iig8/how_does_ipfs_keep_content_i_have_deleted_from_my/

[ryobg]

Hello,
I may intrude, but since I read the whole issue list you can see my notes (maybe run semantic tagging?):

• Addding two more for Private Content:
  • Access Control Access control faq#126
  • File encryption built into IPFS? File encryption built into IPFS? faq#116
• I propose topic for Similarity with other systems:
  • What type of apps would not be a good idea to build on top of IPFS? What type of apps would not be a good idea to build on top of IPFS? faq#1
  • How does IPFS compare with X? How does IPFS compare with X? faq#2
• Another outstanding topic for FAQ How to set up bandwith/storage:
  • How does IPFS based solution solve the uplink/downlink asymmetry problem? How does IPFS based solution solve the uplink/downlink asymmetry problem faq#104
  • Is it possible to limit the size of a local storage? Is it possible to limit the size of a local storage? faq#34
  • Can I control the amount of storage/bandwidth dedicated to IPFS? Can I control the amount of storage/bandwidth dedicated to IPFS? faq#11,
  • Disc Space Cost Function Disc Space Cost Function faq#101
  • sharing files from their current locations sharing files from their current locations faq#62
  • Storing a few TB of data? Storing a few TB of data? faq#5

Best Regards.

[jessicaschilling]

These topics are being addressed in a variety of other open issues in docs repo -- closing as a result.