technical revision of the documentation.

English below

Techische Überarbeitung der Dokumentation.

In den letzen Wochen hatte ich zunehmend Probleme mit der Verwendung von GitBook für unsere Website.
Zum einen, da Features fehlten, zum anderen hat es einfach oft nicht funktioniert. Das hat mich viel Zeit, Nerven und Motivation gekostet.
Nach einiger Recherche hab ich mich für die Konvertierung nach asdciidoc entschieden. Somit sollten wir auch mit wenig Aufwand in der Lage sein pdf/epub zu erzeugen.

Ebenso hat sich herausgestellt, dass es Probleme mit der Versionierung gibt, was sich durch einen unterschiedlichen Release Zyklus von Spezifikation und Website ergibt.
Deshalb habe ich mich entscheiden Website und Spezifikation in 2 getrennten Projekten zu halten.

Publiziert nach:

Was ist noch passiert:

  • Ich hab einiges an Aufwand in die loa-suite gestcekt. Es ist jetzt alles in einem Maven-Multi-Module Projekt zusammengefasst. https://gitlab.com/linkedopenactors/loa-suite
  • und hab einiges an Zeit in die Algorithmen gesteckt, das muss ich aber nochmal anschauen und dokumentieren. Das ist dann die erste Basis die benötigt wird, um Publikationen/Organisaionen zu vergleichen. Hier bin ich dann auf Input angewiesen. Ich gehe davon aus, das Helmut sich hier ein bringt.
  • hannes hat sich um das Wordpress PlugIn gekümmert, das Daten per SPARQL abfgragt und in einer Karte(leaflet) anzeigt.

Was steht als nächstes an:

  • Überarbeitung der Dokumentation
    Ich muss mir mal wieder Zeit nehmen alles durchzuschauen, da ist teilweise veraltete Doku.
  • Bereitstellen einer neuen Development-Version der loa-app
  • Releasen der loa-app inkl. erstellen der ersten release notes
  • Automatisierung des loa-app deployments
#

Was passiert nebenläufig:

  • Ich beschäftige mich viel mit ActivityPub
  • Ich implementiere für einen Kunden einen ActivityPub Client, den wir dann hoffentl. auch benutzen können.
  • Ich versuche immer mal wieder den ActivityPub Client gegen Pleroma laufen zu lassen, stoße jedoch immer wieder auf Hürden.
    ActivityPub kann auf viele Weisen interpretiert werden ;-(

English

technical revision of the documentation.

In recent weeks I have had increasing problems with the use of GitBook for our website.
On the one hand, because features were missing, on the other hand, it simply didn't work very often. This cost me a lot of time, nerves and motivation.
After some research, I decided to convert to asdciidoc. This way we should be able to create pdf/epub with little effort.

It also turned out that there are problems with versioning due to a different release cycle of the specification and the website.
Therefore I decided to keep website and specification in 2 separate projects.

Published by:

What else happened:

  • I put some effort into the loa-suite. It's all in one Maven multi-module project now. https://gitlab.com/linkedopenactors/loa-suite
  • and put some time into the algorithms, but I have to look at that again and document it. This is the first basis needed to compare publications/organisations. Here I am dependent on input. I assume that Helmut will contribute here.
  • hannes has taken care of the Wordpress PlugIn, which grabs data via SPARQL and displays it in a map (leaflet).

What's next:

  • Revision of the documentation
    I need to take some time to look through all the documentation, some of it is outdated.
  • Provide a new development version of the loa-app.
  • Releasing the loa-app incl. creating the first release notes
  • Automation of the loa-app deployment

What happens on the side:

  • I work a lot with ActivityPub
  • I am implementing an ActivityPub client for a customer, which we will hopefully be able to use.
  • I try to run the ActivityPub client against Pleroma from time to time, but I keep running into hurdles.
    ActivityPub can be interpreted in many ways ;-(
    1. 0