adessose / devblog

adesso Developer Blog

adesso SE devblog

WICHTIG: Aufgrund einer Umstellung im adesso-Blog wird das Einreichen neuer Artikel ab Oktober 2023 nicht mehr möglich sein. Außer den Personen die bereits darüber informiert sind, werden keine neuen PRs mehr angenommen.

Dieses Repository beinhaltet Blog Posts für den adesso Blog.

Wie kann ich einen Blog Post veröffentlichen?

Eine Anleitung, wie ein Blog Post über dieses Repository veröffentlicht werden kann, findest du hier.

WICHTIG: Achte bitte auf die Aktualisierung zur Angabe der Autoren

Falls du einige Tipps zum Schreiben eines erfolgreichen Artikels haben möchtest, schau doch mal in unsere Best Practices.

Aktuelle Preview der Blog Posts in diesem Repository

Eine Preview findet ihr hier. Hierbei handelt es sich aber nur um eine Preview, die genau die Blog Posts anzeigt, die in diesem Repository enthalten sind. Sie werden regelmäßig in den adesso Blog integriert.

Fragen?

Bei Fragen zu diesem Repository wende dich an [email protected].

devblog's Issues

Preview lädt sehr lange

Die Previews der PRs dauern aktuell sehr lange zu laden. Im Footer des Browser steht dabei immer, dass er versucht auf "www.adesso.de" zuzugreifen. Das muss gefixt werden, sonst ist die Arbeit mit den Previews nicht wirklich möglich.

Bulletpoints werden in der Vorschau falsch dargestellt

Erwartetes Verhalten wie im Produktionssystem zu finden:

Gegebenes Verhalten in der Vorschau:

Vermutung: Übernahme der aktuellen Styledateien. Gegebenenfalls händische CSS Anpassung.

Lokale Jekyll-Vorschau: Detailseite ist ungestyled

Wenn ich lokal Jekyll zur Vorschau starte, wird die Startseite unter http://localhost:4000 korrekt gestyled angezeigt. Wenn ich dann auf einen Blog Post klicke, wird die Detailseite aber ungestyled angezeigt. Das muss gefixt werden.

Lokale Jekyll-Vorschau: Header

Aktuell werden Header ab h1 in der Detailseite genutzt. Nach der Besprechung mit dem CMS-Projekt dürfen die Überschriften innerhalb eines aber erst mit h3 anfangen.

Ist:
# = h1
## = h2
### = h3

Soll:
# = h3
## = h4
### = h5

Probleme mit langen Titeln auf Preview-Seite

Auf der Preview-Seite gibt es Probleme mit langen Wörtern im Titel. Das Foto des Authors wird zur Seite gedrängt und überlappt mit dem nächsten Post (s. Screenshot).

Lokale Jekyll-Vorschau: Seite auf "/" erreichbar machen

Wenn ich lokal Jekyll zur Vorschau starte, ist die Seite unter http://localhost:4000/devblog erreichbar. Schöner wäre es, wenn die Seite unter http://localhost:4000 erreichbar wäre, dann muss man nicht das suffix suchen.

Startpunkt: in der _config.yml die baseUrl setzen. Dann ist aber das CSS kaputt.

Keypass für die Accounts erstellen, Passwörter ändern & aus Confluence entfernen

Preview als solche kennzeichnen

In der Preview sollte auf jeder Seite deutlich stehen, dass es sich um eine Preview handelt.

Kategorien "Java" und "Microsoft" zusammenfügen

Die Kategorien "Java" und "Microsoft" sollen in die Kategorie "Softwareentwicklung" zusammengeführt werden. Die alten Kategorien werden stattdessen als Tags gesetzt.

• Blogposts aus der Kategorie "Java" in die Kategorie "Softwareentwicklung" verschieben und "Java" als zusätzlichen Tag setzen, Aktualisierungsdatum neu setzen
• Blogposts aus der Kategorie "Microsoft" in die Kategorie "Softwareentwicklung" verschieben und "Microsoft" als zusätzlichen Tag setzen, Aktualisierungsdatum neu setzen
• Anleitungen / Beispiele / PR-Template anpassen

Geschweifte Klammern in Codeschnipseln escapen

In #92 ist aufgefallen, dass doppelte, geschweifte Klammern in Codeschnipseln von Jekyll als Liquid-Tag erkannt werden und diese somit im fertigen Artikel fehlen.

Eine Lösung dafür ist hier auf Stackoverflow beschrieben. Wir sollten diese Information entweder irgendwo erwähnen, oder das dort erwähnte Plugin einbinden.

E-Mail-Adressen aus den authors.yml entfernen

Die E-Mail-Adressen sollen entfernt werden. Dies soll nicht nur über einen neuen Commit passieren, sondern die Historie soll neu geschrieben werden, sodass die E-Mail-Adressen gar nicht mehr abrufbar sind.

Umstellung der Autoren-Infos

Hallo zusammen,

in der Vergangenheit kam es auch hier immer mal wieder vor, das mehrere Autoren an einem Blog-Post zusammen geschrieben haben. Das führt dazu, das im CMS ein neuer Autor angelegt werden muss. Davon wollen wir künftig absehen.

Aktuell gebt Ihr im XML folgende Autoren-Daten beispielsweise an das CMS mit

<!--Author Information-->
<field name="author_first_name"><![CDATA[Cem]]></field>
<field name="author_last_name"><![CDATA[Caylak]]></field>
<field name="author_id"><![CDATA[ccaylak]]></field>
<field name="author_picture_stored_only"><![CDATA[http://localhost:4000/assets/images/avatars/ccaylak.png]]></field>

Die Informationen author_first_name, author_last_name und author_picture_stored_only werden beim Import nicht berücksichtigt und somit auch von unserer Seite nicht benötigt. Wenn Ihr wollt und Ihr die Informationen an dieser Stelle nicht wo anders benötigt, können die Daten aus dem XML enfallen.

Zusätzlich würden wir allerdings dann eine "Liste" von author_id erwarten. Wobei diese Liste insofern keine Liste darstellt. Wir können uns vorstellen, dass die Authoren dann, analog zu Tags, untereinander genannt werden. z.B.

<!--Author Information-->
<field name="author_id"><![CDATA[ccaylak]]></field>
<field name="author_id"><![CDATA[dsorna]]></field>
<field name="author_id"><![CDATA[florianluediger]]></field>

Könnt Ihr dies so bereitstellen?

Bei Fragen kommt gerne auf mich zu.

Viele Grüße
Diana

Probleme mit Job pull-and-run-blogpost-checker-image

Es sieht so aus als hätten PR #241 und #233 dasselbe Problem in den Checks.
Der Job pull-and-run-blogpost-checker-image scheint nicht den richtigen Commit zu nehmen.
Bei beiden MRs ist es 4ff65608dd4d37db6231b7e33fa7f855d148ac91.

Fehlende Tabellen Header

In der Preview sowie in der produktiven Version werden derzeit keine Tabellen Header angezeigt.

Die HTML Elemente thead sind vorhanden, jedoch wird die color: white aus dem body geerbt, weswegen kein Text zu sehen ist.

Beispiele:

• Prod: https://www.adesso.de/de/news/blog/logging-vs-tracing-2.jsp - Tabelle unter Fazit
• Preview: https://deploy-preview-250--adesso-devblog-pr-preview.netlify.app/blog-posts/2022-07-27/komplex-vernetzte-logistikdaten-persistieren/komplex-vernetzte-logistikdaten-persistieren#fn:1 - Tabelle zur Annotation-API

Suchmaschinen-Indizierung für Preview deaktivieren

No-Index Tag ergänzen

Adopt the new blog design

The main adesso blog has got a design overhaul, which should be adopted in this preview.

Adjust preview label

The preview-label overlapped the content, it has been sized down (its a netlify preprocessing-feature) and can't be found in the code.
See the new preview: https://adesso-devblog-preview.netlify.com/

Idee: Ein Previewbild pro Blogpost

Mir ist aufgefallen, dass die Darstellung der kürzlich veröffentlichten Artikel monoton aussieht:

Wenn wir anfangen für neue Blogposts ein Bild zu hinterlegen, können wir die Ansehnlichkeit steigern und Besucher umso mehr motivieren auf unsere Artikel zu clicken.

PR-Template and publish-checklist

Integrate a publish-checklist in the tutorial and create a pr-template with it.

Translate Pull-Request Template to english

Should be translated to english to match the Readme and make more enablement possible

Veröffentlichungen planen

Erleichterung/ Management der Planung wann welcher Artikel veröffentlicht werden soll.

Trigger action "convert-blogpost-to-xml" on push to master

Neue Kategorien ab dem 01.07.2021

Hallo zusammen,

ab dem 01.07.2021 werden wir (CCO) die Kategorien für den Blog ändern.

Für euch relevant/interessant: Es werden zwei neue Kategorien veröffentlicht. Zum einen KI und zum anderen Digital Experience

Könnt Ihr diese bitte in eure Dokumentation mit aufnehmen? Geplant ist auch bis zum Ende des Jahres die Kategorie Cloud. Wenn sich da ein paar Postings finden, können wir uns auch vorstellen die Kategorie früher zu veröffentlichen.

Bei Fragen kommt gerne auf uns zu.

Viele Grüße
Diana

Disable workflow execution for jekyll2cms on forks

In forks of adessoAG/devblog the actions are also triggered. We should stop the triggering or at least make it pass without errors for forks, because we're not interested in these forks and their run results. Right now, we're getting the email notifications though.

as in adessoSE/jekyll2cms#86

Pagination Buttons verdecken teilweise den Inhalt in der Preview

Fixen des neuen Blog-Designs

In #91 wurde das neue Blog-Design grundsätzlich übernommen, allerdings werden Artikel nicht korrekt dargestellt. Der Hauptteil des Textes befindet sich unter der Fußzeile, welche die Informationen für den Autor enthalten. Außerdem ist dieser Text viel zu breit.

Codeschnipsel werden im adesso Blog nicht richtig dargestellt

In unserer Preview ist noch alles korrekt, in dem tatsächlichen adesso Blog werden bei Codeschnipseln allerdings alle Leerzeilen gelöscht und die erste Zeile ein kleines Stückchen eingerückt.

Ein Beispiel findet sich in diesem Artikel:

• Preview
• adesso Blog

Dieses Issue soll nur der Dokumentation dienen, ich werde per E-Mail Kontakt zur Arithnea aufnehmen.

Enable future-post-preview and update preview-banner

Future posts shall be displayed in the preview.
Also the preview-snipped shall be removed from netlify, which is really unintuitive.
#47

URL "blog.adesso.de" führt nicht zum Blog

Hallo zusammen,
seit einiger Zeit führt blog.adesso.de lediglich zur normalen Website und nicht, wie erwartet, zum Blog. Der ist nur unter https://blog.adesso.de/de/news/blog/index.jsp erreichbar. Hinsichtlich der UX ist dies ein unerwartetes Verhalten. Ist das etwas, dass wir fixen können?

Insofern hier kein Einfluss darauf genommen werden kann, könnte es lohnenswert sein die zuständige Partei (CCO?) diesbezgülich aufmerksam zu machen.

Viele Grüße
Sergej

Lokale Jekyll-Vorschau: XML-Posts aus Übersichtsseite entfernen

Die Blog Posts werden in der Übersichtsseite sowohl in der XML- als auch in der HTML-Version verlinkt. In der Vorschau sollte nur die HTML-Version angezeigt werden, damit man die Blog Posts vernünftig reviewen kann.

Kategorie Architektur oder Architekturen

Im adesso Blog heißt die Kategorie "Architektur", im PR-Template schreiben wir "Architekturen" als mögliche Kategorie. Wird das intern umgewandelt? Wenn nicht müssen wir das im PR-Template anpassen, da die Nutzer sonst an der Stelle die falschen Kategorien verwenden und es zu Fehlern kommt.

Buchstabe im Namen fehlt

Hi,

in einem bereits veröffentlichten Post von mir fehlt ein "c" in meinem Nachnamen, sowohl im Teaser, als auch im Post selbst.
Ist: Philippe Shild
Soll: Philippe Schild

Die authors.yml sieht m.E. korrekt aus.
Könnt ihr euch das mal anschauen?

Update pr_template: Authors should indent one sentence per line

Reviewing blog posts is easier when you can adress specific lines and phrases directly.
To make use of this feature on GitHub every sentence must have it's own line.
Since not all authors are aware of this, I suggest adding a (mandatory) hint that authors should indent their articles to one sentence per line. E.g.

Wrong:

+ One sentence. Sentence I want to adress. Next sentence.

Correct:

+ One sentence.
+ Sentence I want to adress.
+ Next sentence.

I suggest adding this point to the Pull Request Template.

Teaser ist nicht passend zum jeweiligen Post

Der angezeigte Teaser ist nicht passend zum jeweiligen Post, sondern statisch.

Extend example markdown file

Add the following features to the example markdown file:

• image
• syntax highlighting
• headlines and sub-headlines (as many levels of headlines as are allowed in the target layout)

Also, the example markdown file should contain a getting started guide for how to add a blog post.

Teaser text not displayed in detail page

In a published blog post the teaser text is not displayed on the detail page of a blog post.

TODO: Add the teaser text to the xml output

Kategorien in der Vorschau falsch

Bitte die Kategorien prüfen. "Branchen & People" wurde aufgeteilt in "Branchen" und "Inside adesso".

Replace relative links with absolute

https://gist.github.com/smutnyleszek/9803727
{{ 'foofoo' | replace:'foo','bar' }}

Replace relative links like ../assets/... links in posts at jekyll2cms generation time with absolute path to localhost:4000/assets...

Fix list style type in preview

In the deploy preview (Image 1) the list style type does not match the list style type of the official adesso blog (Image 2).

Remove email address from documentation