Improve IPNS spec

Abierto
#205 5 comentarios 3 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
20/100
Tipo de issue
Documentación
Claridad
Necesita aclaración
Estado de actividad
Estancado

Línea de trabajo

Comienza leyendo la especificación actual de IPNS y la issue #198 sobre las especificaciones referenciada. Revisa las preguntas sobre terminología, tipos de datos, networking, comportamiento del router, DNSLink y extensibilidad enumeradas aquí. El trabajo estará terminado cuando exista una especificación de IPNS acordada y aclarada que cubra las preguntas abiertas y los requisitos de implementación.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

The IPNS spec currently combines a lot into a single document and leaves some issues ambiguous. The main issues to tackle are:

  1. Terminology
    • Spec names of IPNS path components:
      • /ipns/
      • /ipns/bafy...
      • /ipns/bafy.../images/pic.jpg
      • bafy...
      • /images/pic.jpg
  2. Data Types (mostly in the spec already)
  3. Networking and Protocol spec
    • Existing router behaviors
      • dht
      • pubsub
      • dns
    • IPNS protocol
      • What must be implemented to be considered IPNS?
      • How is behavior in the presence of multiple routers defined?
        • publish strategy
          • republish/pinning strategy
        • resolve strategy
        • define specifications new routers must meet (e.g. must it support third party republishing, must it
      • If streaming updates from resolve (or to publish) is part of the spec it should be defined
  4. Other
    • Do we want to spec out any implementation suggestions or defaults?
    • Do we want to specify any extensibility points up front, or just PR the spec in the future?
    • Be explicit about DNSLink in /ipns/ namespace:
      • why we allow DNS names? what are the rules of interop? is there a plan to change current situation?
      • is supporting DNSLink required by IPNS implementers?
        • how should IPNS implementers who don't support DNSLink denote the IPNS namespace?

refs:
https://github.com/ipfs/specs/issues/198

/cc @aschmahmann @lidel

Lenguaje dominante
HTML
Estrellas
1.2k
Forks
250
Métricas de merge de PR
Sin PR fusionados en 30 d

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de ipfs/specs

Todos los issues de ipfs/specs

Issues similares

Más issues de Distributed Systems

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.