Information: Solide Informationsstruktur

Erstellt am 22. Jan. 2019  ·  4Kommentare  ·  Quelle: solid-archive/information

Wie sollen Menschen, denen Solid nicht vertraut ist, die Informationen aufnehmen und sich orientieren? Ich habe unvollkommene Vorschläge beschrieben, die darauf abzielen, das Gespräch zu eröffnen, um gemeinsam zu einem Ergebnis zu kommen. Mir ist besonders wichtig, dass diejenigen, die bereits an wesentlichen Elementen gearbeitet haben, an dem beteiligt sind, was sie bereits im Kopf hatten. Man muss das Rad nicht neu erfinden, sondern nur erklären, wo das Rad steht.

Ich habe am Community Repo als Ausgangspunkt gearbeitet, um die Übersicht zu geben https://github.com/solid/community. Wollen wir mit diesem Ausgangspunkt weitermachen? Gibt es irgendwelche Verbesserungen, die wir an der Einführung vornehmen könnten, zum Beispiel Schlüsselelemente, die aufgenommen werden sollten?

Die Ziele werden in der Spezifikation und Architektur in der Readme-Datei der Community beschrieben. solid-architecture, solid-spec und web-access-control-spec sind drei Repos, die in das Community-Repo aufgenommen oder separat gehalten werden können. Vorlieben? Vielleicht könnte die Architektur eine Karte aller Non-Governance-Repos liefern, um ein Bild von jeder der Funktionen und ihrem Zusammenspiel zu geben.

Einige Informationen sind im Community-Repo und anderen Repositories doppelt vorhanden. Was wäre aus makroökonomischer Sicht die logischste Verteilung dieser Informationen?

Ein paar Anregungen...

Wir brauchen einen Platz für Solid-Ressourcen, einschließlich Vorträgen über Solid, Solid-Artikeln sowie allgemeiner Online-Ressourcen, die zum Verständnis von Solid nützlich sind. https://github.com/solid/community/blob/master/solid-resources.md wurde mit diesem Ziel entworfen. Die folgenden Elemente decken jedoch ähnliches Material ab und könnten koordiniert werden: solid-tutorial-intro, solid-tutorial-angular, solid-tutorial-rdflib.js, profile-viewer-tutorial, Understanding-linked-data, solid-tutorial-pastebin , Web-Gipfel 2018, Einführung in solide Folien. Wir könnten Links zu den Repos erstellen oder die Informationen in solid-resources.md zusammenführen. Vorlieben?

https://github.com/solid/vocab und https://github.com/solid/community/blob/master/solid-dictionary.md decken ähnliches Material ab – wie könnten wir diese miteinander verflechten?

https://github.com/solid/solid-apps und https://github.com/solid/community/blob/master/solid-apps.md decken ähnliches Material ab – wie könnten wir diese miteinander verflechten?

https://github.com/solid/userguide hat großartiges Einführungsmaterial, wann sollte ein Neuling damit vertraut gemacht werden?

https://github.com/solid/releases Wo sollte dies leben und wie sollte es mit dem Community-Repo verknüpft werden?

Irgendwelche Gedanken darüber, wie und wann Neulinge auf Folgendes stoßen sollten:
https://github.com/solid/solid-Namespace
https://github.com/solid/solid-platform
https://github.com/solid/solid.mit.edu

Hilfreichster Kommentar

@justinwb Klar, PR funktioniert auch. Auf jeden Fall https://github.com/solid/solid-apps/issues/18 erstellt.

Alle 4 Kommentare

IMO, wenn es ein Repo mit einem bestimmten Zweck gibt, migrieren Sie relevante Informationen, die sich an anderer Stelle befinden, in dieses Repo. Behandeln Sie das dedizierte Repo als kanonisch. Beziehen Sie sich darauf an anderer Stelle.

Ich verstehe nicht, warum https://github.com/solid/community/blob/master/solid-apps.md existiert, wenn https://github.com/solid/solid-apps älter ist und verwendet wird. Es gibt auch keine Provenienz (wie „abgeleitet von“ oder „kopiert von“).

Als Vokabular und Solid-Wörterbuch haben sie unterschiedliche Zwecke und Materialien.

Ich dachte, dass vielleicht einige Informationen von der Community selbst verwaltet werden können. Ich bin mir nicht sicher, ob Repos wie Solid-Apps über PRs verarbeitet werden müssen. Ein (GitHubs) Wiki kann gut funktionieren, solange es einen Änderungsverlauf und eine Möglichkeit für Manager/Administratoren oder was auch immer gibt, ein Rollback durchzuführen.

@csarven Ein Argument dafür, dass Solid-App-Ergänzungen Pull-Requests durchlaufen lassen, besteht darin, ein gewisses Maß an Überprüfung zu haben, ob eine App gut gemeint und nicht bösartig ist. Immer noch kein perfektes System, und es gibt keine Garantie dafür, dass die PR-Genehmigung alles erfassen würde, aber es gibt zumindest ein gewisses Maß an Qualitätsprüfung, bevor etwas gelistet wird.

@justinwb Klar, PR funktioniert auch. Auf jeden Fall https://github.com/solid/solid-apps/issues/18 erstellt.

War diese Seite hilfreich?
0 / 5 - 0 Bewertungen

Verwandte Themen

Mitzi-Laszlo picture Mitzi-Laszlo  ·  26Kommentare

NSeydoux picture NSeydoux  ·  4Kommentare

kjetilk picture kjetilk  ·  12Kommentare

eduardoinnorway picture eduardoinnorway  ·  3Kommentare

RubenVerborgh picture RubenVerborgh  ·  23Kommentare