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

Expand IPNS concept doc #244

Closed
Mr0grog opened this issue Jul 25, 2018 · 18 comments
Closed

Expand IPNS concept doc #244

Mr0grog opened this issue Jul 25, 2018 · 18 comments
Labels
dif/hard Having worked on the specific codebase is important effort/days Estimated to take multiple days, but less than a week kind/enhancement A net-new feature or an improvement to an existing feature P3 Low: Not priority right now status/inactive No significant work in the previous month topic/docs Documentation

Comments

@Mr0grog
Copy link

Mr0grog commented Jul 25, 2018

This issue has a bounty!

Successfully closing this issue by producing a production-ready piece of documentation can earn you not only the undying love of the IPFS community — it can net you a financial reward. See the current list of bounty issues and their values here.

The need in brief

We need to expand and improve upon the existing IPNS page in our docs; information is incomplete and some is out of date.

At the IPFS developer summit in Berlin in July 2018, we had poster-making sessions where people explored various IPFS concepts. Please examine the posters (contacts for their creators can be provided if necessary) and include its information both in the body text of the revised doc, and in a graphic suitable for publishing on the IPFS docs beta site.

ipns

ipns_publish-resolve

Additionally, please examine the more recent material that has been developed on related topics:

Please both link out to these artifacts in a "further information" section at the end of the doc, as well as incorporate summary/high-level concepts from the artifacts within the doc itself.

Finally, please examine the existing content in the original doc and update any content that may be inconsistent, unclear, or out of date.

Deliverable

An expansion of the original concept doc that fully integrates the considerations outlined above. As a whole, this revised concept doc should answer the following, supplemented whenever possible by diagrams, videos and/or code examples:

  • What is this?
  • How does it relate to the rest of IPFS?
  • What are some generic use cases for this — how might it meet a need in someone's project/goal?
  • How can (or should?) you use it? (Note: sometimes the answer is that you should understand it, but not necessarily use it based on your use case or the current state of the tech.)
  • Where do you go to learn more?
  • What is the current state of this concept or technology?

Content should take the form of a Markdown document, supplemented by diagrams as embedded images. File locations should be as follows:

Guidelines

  • Please use the IPFS Docs Contributor Guidelines as your north star — adherence to these guidelines are crucial when it comes to awarding potential bounty!
  • Also, please keep in mind our core user personae. If a piece of content serves one or more personae in particular, make sure it checks out with that persona's attributes.
@jessicaschilling jessicaschilling changed the title Expand IPNS concept doc with info from Berlin posters Concept Doc: Expand IPNS concept doc with info from Berlin posters Jul 26, 2019
@jessicaschilling jessicaschilling changed the title Concept Doc: Expand IPNS concept doc with info from Berlin posters Expand IPNS concept doc with info from Berlin posters Sep 19, 2019
@jessicaschilling jessicaschilling changed the title Expand IPNS concept doc with info from Berlin posters [CONTENT IMPROVEMENT] Expand IPNS concept doc with info from Berlin posters Dec 16, 2019
@jessicaschilling jessicaschilling changed the title [CONTENT IMPROVEMENT] Expand IPNS concept doc with info from Berlin posters [CONTENT IMPROVEMENT] Expand IPNS concept doc Dec 16, 2019
@jessicaschilling
Copy link
Contributor

@johnnymatthews What say you to putting a bounty on this one?

@jessicaschilling jessicaschilling changed the title [CONTENT IMPROVEMENT] Expand IPNS concept doc [CONTENT IMPROVEMENT] [BOUNTY] Expand IPNS concept doc Feb 24, 2020
@jessicaschilling
Copy link
Contributor

Bounty added! This one is up for grabs. Please comment if you'd like to take it on! The reward is USD $500.

@johnnymatthews johnnymatthews changed the title [CONTENT IMPROVEMENT] [BOUNTY] Expand IPNS concept doc Expand IPNS concept doc Apr 17, 2020
@dzhelezov
Copy link

Is this issue still open for grabs?

@jessicaschilling
Copy link
Contributor

Sure is! Just assigned it to you. @johnnymatthews is running the docs show these days, so please check in with him for any questions!

@johnnymatthews
Copy link
Contributor

Hey @dzhelezov! The issue is still open, but with the release of Go-IPFS 0.5 coming out next week, there's a bunch of changes to this doc just about to go out. So for now, there aren't any major changes necessary for this doc. There's still loads you can help out with though! Check back next week for a fresh set of bounties.

@dzhelezov
Copy link

Hi @johnnymatthews! awesome news, thanks for the update! As far as I understood IPNS is going to support ENS, handshake and pretty much any other protocol in a plugin fashion, is it already available in 0.5? Would be happy to cover that as well once available.

@hsanjuan hsanjuan transferred this issue from ipfs-inactive/docs May 22, 2020
@bertrandfalguiere
Copy link
Contributor

@dzhelezov, are you still working on it? I would like to take this on if you don't plan to work on it anymore.

@dzhelezov
Copy link

@dzhelezov, are you still working on it? I would like to take this on if you don't plan to work on it anymore.

Hi sure feel free to take it, but I am not sure about the current status of this issue -- @johnnymatthews put it on hold back in April

@johnnymatthews
Copy link
Contributor

Oh wow, I dropped the ball on this one. Sorry about that. Yes this project is back up for grabs! I'll assign it to you @dzhelezov if you're ready? There's some features in Go-IPFS 0.6 that might affect this page. Feel free to email me (address on my GitHub profile with any questions).

@dzhelezov
Copy link

@johnnymatthews I am currently busy with another project so perhaps @bertrandfalguiere can take over. I would be happy to share what I've researched and compiled back in April.

@johnnymatthews
Copy link
Contributor

johnnymatthews commented Jul 1, 2020

Sorry, through the wrong username in my last comment. @bertrandfalguiere if you're available it's all yours.

@bertrandfalguiere
Copy link
Contributor

@johnnymatthews To be exact, I'll be on vacation Friday and the next week. I will be able to work on it after that, so if someone is available before july 13th, they can have the ticket, otherwise I'll handle it myself.
@dzhelezov Having your previous work would help, thanks for offering it.

@dzhelezov
Copy link

Here's a (small) write-up I added to the IPNS page: master...dzhelezov:master

@dzhelezov
Copy link

dzhelezov commented Jul 10, 2020

The following additional resources may be useful to follow the development of IPNS, but I guess some additional care should be taken to figure out what has been actually implemented in IPFS 0.5:

@realChainLife
Copy link
Contributor

@bertrandfalguiere are you still working on this? I can give it a go if you're not

@bertrandfalguiere
Copy link
Contributor

Yes, still on it. I will ship end of next week, though.

@johnnymatthews
Copy link
Contributor

How's this issue going @bertrandfalguiere?

@johnnymatthews johnnymatthews added dif/hard Having worked on the specific codebase is important effort/days Estimated to take multiple days, but less than a week kind/enhancement A net-new feature or an improvement to an existing feature P3 Low: Not priority right now status/inactive No significant work in the previous month topic/docs Documentation labels Sep 8, 2021
@BlocksOnAChain
Copy link

we can close since we have: https://docs.ipfs.io/concepts/ipns/#example-ipns-setup-with-cli

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dif/hard Having worked on the specific codebase is important effort/days Estimated to take multiple days, but less than a week kind/enhancement A net-new feature or an improvement to an existing feature P3 Low: Not priority right now status/inactive No significant work in the previous month topic/docs Documentation
Projects
None yet
Development

No branches or pull requests

7 participants