freifunk / freifunk/api.freifunk.net

Migration von JSON Schema draft-3 zu draft-7

Open
#151 2 comments 1 reaction 0 assignees View on GitHub
Dominant language
Makefile
Stars
51
Forks
24
PR merge metrics
No merged PRs in 30d

Description

Laut https://json-schema.org/specification.html sind

- draft-7
- draft-6
- draft-4

derzeit die aktuellen Spezifikationen. Ältere Spezifikationen werden hier gelistet:
https://json-schema.org/specification-links.html
und dort als "**expired**, but may be of historical interest" aufgeführt.

Freifunk setzt bisher **draft-3** ein. Diese Spezifikation ist von 2010. Neuere Validatoren haben keinen Support mehr für diese alten Spezifikationen und ältere Validatoren werden oft nicht mehr gepflegt, womit **Vulnerabilities / Security Issues** wahrscheinlich sind / wahrscheinlicher werden.

Ich rate dazu zusätzliche zu den draft-3 Freifunk JSON Schema Dateien nun auch draft-7 Dateien bereitzustellen, um eine **Soft Migration** zu ermöglichen. Zudem würde ich an bekannte Script- / Client-Entwickler, sowie in forum.freifunk.net und an technische Ansprechpartner in den lokalen Gruppen (E-Mail) eine **DEPRECATION NOTICE** bzgl. draft-3 veröffentlichen, mit der Bitte um **Migration auf draft-7** bis zum **31.12.2019**.

Zu diesem Zeitpunkt würde ich gerne die draft-3 Dateien aus unserem Repo entfernen, nachdem wir natürlich "geprüft" haben wie gut draft-7 adaptiert wurde. Dieser Vorgang ist nicht disruptiv - eine Soft-Migration.

Mir fallen folgende Scripte / Clients ein:
- API Generator: https://github.com/freifunk/api.freifunk.net/tree/master/generator
- Travis-CI Build Check: https://github.com/freifunk/directory.api.freifunk.net/tree/master/tests
- Community Registry Monitor: http://community-registry.ff-hamm.de/

Bitte helft mit alle bekannten Freifunk-Scripts / -Clients hier zu listen, damit wir bei der Migration keines vergessen.

Bevor sich jemand den Aufwand macht draft-7 Freifunk JSON Schema Dateien zu erstellen, wäre es schon, hierzu vorab Eure Meinung zu bekommen.

Wie denkt Ihr darüber?

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.