-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathindex.xml
More file actions
3661 lines (3569 loc) · 318 KB
/
index.xml
File metadata and controls
3661 lines (3569 loc) · 318 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Josia's Blog</title><link>https://jscheytt.github.io/</link><description>Recent content on Josia's Blog</description><generator>Hugo -- gohugo.io</generator><language>en-us</language><copyright>Josia Scheytt</copyright><lastBuildDate>Mon, 26 Aug 2024 12:01:54 +0200</lastBuildDate><atom:link href="https://jscheytt.github.io/index.xml" rel="self" type="application/rss+xml"/><item><title>Jesus ist wie ein schwarzes Loch</title><link>https://jscheytt.github.io/p/jesus-ist-wie-ein-schwarzes-loch/</link><pubDate>Mon, 26 Aug 2024 12:01:54 +0200</pubDate><guid>https://jscheytt.github.io/p/jesus-ist-wie-ein-schwarzes-loch/</guid><description><p>🚨 <em>Mein laienhaftes Verständnis von schwarzen Löchern basiert auf wenigen YouTube-Videos.
Vermutlich stelle ich einige Sachverhalte zu vereinfacht oder sogar inkorrekt dar.</em></p>
<p>Vor kurzem haben wir bei einem Gebetstreffen einige Verse von <a class="link" href="https://www.bibleserver.com/ELB.NG%C3%9C/Lukas15" target="_blank" rel="noopener"
>Lukas 15</a> betrachtet, in denen Jesus ständig von Sündern umgeben war, die Ihm an den Lippen hingen und für die Er in Seiner Liebe total anziehend war.
Für mich kam dabei folgender Vergleich in den Sinn:
Wenn Jesus ständig von Sündern umgeben war, weil sie Ihm so nahe sein wollten, dann gleicht Jesus einem schwarzen Loch.</p>
<p>Folgende Punkte schließt das für mich ein:</p>
<p>Ein schwarzes Loch ist der Überrest von einem oder mehreren ehemaligen Sternen.
Es ist relativ klein im Vergleich zu der <strong>unvorstellbar großen Masse</strong>, die es hat.</p>
<ul>
<li>Das Wort &ldquo;Kavod&rdquo; im Hebräischen bedeutet sowohl Herrlichkeit als auch Gewicht.
Gottes Gewicht und Herrlichkeit ist unermesslich groß.</li>
<li>Obwohl es hinsichtlich seiner Größe eigentlich unscheinbar ist (und sogar de facto unsichtbar ist, weil es Licht schluckt), hat es aufgrund seiner Masse eine ungeheure Wirkung und Anziehungskraft.
Aufgrund dieser Anziehungskraft erreichen Himmelskörper, die es umkreisen, teilweise fast schon Lichtgeschwindigkeit.</li>
<li>Ebenso ist auch Gottes Reich rein äußerlich kaum auszumachen, aber Seine Auswirkung ist gewaltig (siehe Jesu Gleichnisse vom Himmelreich).</li>
</ul>
<p><strong>Graviation wirkt gegenseitig</strong>:
Eine große Masse (z. B. ein schwarzes Loch) zieht eine kleine Masse (z. B. einen Planeten) an, aber auch die kleine Masse wirkt eine Anziehungskraft auf die große Masse aus.
Aber es ist ganz eindeutig, welche Kraft stärker wirkt:
Die große Masse zieht die kleinen Massen unfassbar viel stärker an als die umgekehrt.
So ist auch Gottes Verlangen nach uns unvergleichlich viel größer als unser Verlangen nach Ihm.</p>
<p>Ein schwarzes Loch ist eigentlich <strong>nicht sichtbar</strong>.
Aber die Himmelskörper, die von einem schwarzen Loch angezogen werden, kommen ihm immer näher und bilden eine dichte Scheibe aus Materie, die sogenannte Akkretionsscheibe.
Anhand dieser Akkretionsscheibe um das schwarze Loch herum (und auch durch andere Krümmungseffekte aufgrund der starken Masse des Lochs) wird es überhaupt es sichtbar.
Genauso schafft sich Gott in Seinen Nachfolgern eine <em>Verkörperung</em>.
An uns und unserer Liebe zueinander wird Er selbst und Seine Herrschaft sichtbar.</p>
<p>In dieser Akkretionsscheibe sind <strong>alle möglichen Himmelskörper</strong>.
Sie sind ganz unterschiedlicher Art und Größe und Herkunft.
Das, was sie vereint, ist dass sie von dem schwarzen Loch angezogen wurden und dass sie gemeinsam das Loch umkreisen und immer näher hineinwandern.
Genauso sind auch wir nicht aufgrund unserer Errungenschaften in die Nachfolge Jesus hinterher gekommen, sondern aufgrund Seiner enormen Liebe und der Attraktivität Seines Erbarmens.
Und in diesem Vergleich ergibt es völlig Sinn, dass der Apostel Johannes in seinem ersten Brief schreibt, dass <strong>die Liebe zu Gott und die Liebe zu den Geschwistern</strong> ein und dasselbe ist.
Wenn wir uns Gott nahen, werden wir automatisch auch unseren Geschwistern nahe.</p>
<p>Ab dem sogenannten <strong>Ereignishorizont</strong> des Lochs gibt es kein Zurück mehr. Alles, was sich außerhalb dieses Radius befindet, kann sich (mit genügend Schub) noch abwenden. Aber was diesen Radius überschreitet, kehrt nie wieder zurück. (Das gilt sogar für Licht. Deshalb ist das Innere eines schwarzes Loches unsichtbar.)</p>
<ul>
<li>Wenn wir Jesus nachfolgen, wird bei unserem Tod der Übergang von dieser Welt in die neue Welt so sein wie das Überschreiten des Ereignishorizonts: Wir haben bereits davor in beständiger Ausrichtung auf Ihn gelebt, und wenn wir diese Grenze überschreiten, wird Er ganz vollständig unser Leben sein. Wir führen das Leben der ewigen Art, das wir davor geführt haben, einfach ohne wirkliche Unterbrechung für uns fort.</li>
<li>Für die &ldquo;Außenstehenden&rdquo;, die die Grenze noch nicht überschritten haben, wird es freilich aussehen, als hätten wir aufgehört zu existieren. Aber in Wirklichkeit sind wir lebendiger als je zuvor, weil wir ganz in Ihm sind.</li>
</ul>
<p>Zuletzt verlassen wir das Bild und die Realität ein wenig:
Stellen wir uns vor, dass wir, wenn wir als Himmelskörper dem schwarzen Loch nahekommen, weil uns seine Masse angezogen hat, mit der Zeit auch <strong>Masse von ihm aufnehmen</strong>.
Bildlich gesprochen erleben wir ja, dass Gott uns sättigt, wenn wir uns Ihm zuwenden und auf Ihn ausgerichtet leben.
Und Er lebt ja tatsächlich <em>in uns</em>.
Dementsprechend werden wir immer gewichtiger, und andere um uns herum können dann ebenfalls von uns angezogen werden.
Aber weil der <em>Ursprung</em> dieser Masse klar ist, wird diese Art von Anziehung letztlich nicht zu einem Kreisen um uns führen, sondern wird uns alle gemeinsam tiefer in das Leben hineinführen, in dem wir auf Ihn ausgerichtet bleiben und um Ihn kreisen.</p></description></item><item><title>Our GitOps book is available</title><link>https://jscheytt.github.io/p/our-gitops-book-is-available/</link><pubDate>Wed, 01 May 2024 10:26:25 +0200</pubDate><guid>https://jscheytt.github.io/p/our-gitops-book-is-available/</guid><description><p>We did it:
Our <a class="link" href="https://gitops-book.dev/" target="_blank" rel="noopener"
>full-length book about GitOps in German</a> is now finally out!
You can order it anywhere in book stores both physical and online.</p>
<p>In fall 2023, Baris, Johannes, and me started writing this book with a vision for enabling German-speaking software teams to use GitOps so they can ship changes faster and with more confidence.
It is both the first book about GitOps in German, and from our research it seems like it is also by far the longest book <em>in any language</em> about GitOps (about 350 pages).</p>
<p>Are we going to translate it to English?
We sure are interested in doing so but we are still discussing how to do it in a consistent and cost-effective way.</p></description></item><item><title>Documentation as Scaled Communication</title><link>https://jscheytt.github.io/p/documentation-as-scaled-communication/</link><pubDate>Tue, 24 Oct 2023 08:21:20 +0200</pubDate><guid>https://jscheytt.github.io/p/documentation-as-scaled-communication/</guid><description><p>Technical documentation is important, but almost no one enjoys writing it.
At least, I have yet to meet anyone who shares my passion for writing docs.
To me, documentation is not just a chore you do to check a compliance box.
In fact, I believe it can even be a rewarding experience.</p>
<p>I am also convinced that writing documentation is a <em>core skill for Platform Engineers</em> running any <a class="link" href="https://internaldeveloperplatform.org" target="_blank" rel="noopener"
>Internal Developer Platforms</a>.
Developer Platforms need a product mindset, and products need documentation so that users can understand usage and discover features.
And I believe that <strong>technical documentation is a means to scale up your communication</strong>, especially in the platform context.</p>
<p>Let me explain with an example:
If someone pings me directly and asks about a specific technical problem in using the platform (e.g. &ldquo;How do I restart my application in staging?&rdquo;), I could respond via a video call (most expensive option, but sometimes necessary) or by giving them the necessary steps directly.
As an alternative, I could also take a few extra minutes to write a documentation article (e.g. a runbook) about it and send the person a link to the article.
The next time someone asks about this specific problem, I can <em>save a lot of time</em> by not writing out the steps in all detail again.
Instead, I can get into the habit of responding to common questions with links to documentation.</p>
<p>This can not only reduce the time <em>you alone</em> spend handling requests:
If your documentation platform has a good search functionality, you may eventually be able to <em>teach people to search through the docs</em> before making requests, saving time for both Platform Engineers and Developers.
If your documentation tools are configured as openly as possible for contributions, you might even get people to <em>actively participate</em> in improving your articles, perhaps even writing new ones themselves.</p>
<p>I have witnessed some of these effects firsthand.
Let me name this observation <strong>Documentation as Scaled Communication</strong> (or DASC, if you feel like using acronyms).
I am sure that this principle applies very broadly, but I want to keep the focus of this post on <em>technical documentation</em> and on <em>Platform Engineers</em> because that is my primary background.</p>
<h2 id="challenges">Challenges
</h2><p>So why is writing docs so <em>hard</em>?
From my point of view, we have several challenges to address:</p>
<ol>
<li>We need to learn <strong>communication</strong> through practice, review, and feedback.</li>
<li>We also need to learn <strong>writing</strong> (again, through practice, review, and feedback).</li>
<li>Documentation tools need <strong>extremely low friction</strong> (i.e. very good UX).</li>
<li>Tools need to be <strong>configured as wide open</strong> as possible for contributions.</li>
</ol>
<h3 id="practicing-communication">Practicing Communication
</h3><p>How can you communicate effectively?
Effectiveness is always determined by the goals of your communication.
Let&rsquo;s say we have the following goals for platform engineering:</p>
<ul>
<li>Enable developers to be highly productive</li>
<li>Enable development teams to deploy to production quickly and with confidence</li>
</ul>
<p>These goals put us in a position where <strong>empathy</strong> plays a critical role.
I am not talking specifically about <em>technical means</em> like surveys or specific SLOs.
What I am talking about is a certain <em>attitude</em> towards the consumers of our services.</p>
<p>Raw data and measurements are helpful, and they can certainly guide us as we try to learn from incidents or understand certain usage patterns.
But numbers have their limits, and the people who use our services are not distant technical entities, but <em>blood and flesh humans struggling to deploy features and fix bugs</em>.
Learning to empathize with our users can include the following:</p>
<ul>
<li>Sit down with a user (maybe even in person, if possible) and ask for feedback on how they use the platform.
<ul>
<li><strong>Asking proactively</strong> is radically different from waiting for bug tickets and incident reports.</li>
</ul>
</li>
<li>Listen actively:
<ul>
<li>First, listen (you may even want to take notes).
Then keep asking questions to find out what the user is <em>really</em> trying to accomplish.</li>
<li>Your primary focus should not be to get fodder for your bug tracker.
(Take notes, though, if something comes up that you did not know about.)
Instead, **focus on understanding the user&rsquo;s overall interaction with your services:</li>
<li>How do they develop and generally work as a team?
What is their workflow like?
Where are they least productive?
Are they using tools outside your platform that could or should be integrated?</li>
</ul>
</li>
<li><strong>Don&rsquo;t insist on your preferences</strong>.
The platform is not there for its own sake, but to enable the developers.
<ul>
<li>This is most evident when I answer complaints with &ldquo;But that&rsquo;s not how the system is supposed to be used! Did you even read xyz?&rdquo;</li>
<li>I struggle with this point a lot.
When you build a platform, you design for certain usage patterns.
But you can never anticipate how those needs might change in the future.
And if those needs change drastically, you may have to refactor your platform to a greater extent (which will cause you a lot of work).</li>
<li>I&rsquo;m not advocating blindly following every user suggestion &mdash; your product owner will have to prioritize things anyway.
I am also not discouraging helping people understand how to use the existing platform effectively.
My point is:
If you scold people for trying to get things done, you will discourage them.</li>
</ul>
</li>
</ul>
<p>There are a few more resources I recommend for learning to communicate effectively as a Platform Engineer:</p>
<ul>
<li>Watch this talk about &ldquo;<a class="link" href="https://www.infoq.com/presentations/incidents-investigation" target="_blank" rel="noopener"
>How did it make sense at the time?</a>&rdquo; (HDIMSATT).
It is focused on incidents but the same reasoning is helpful for learning empathy with your users.</li>
<li><em><a class="link" href="https://sre.google/sre-book/operational-overload" target="_blank" rel="noopener"
>SRE Embedding</a></em>:
Sometimes, you can take empathy to a more extreme level by embedding a Platform Engineer into an app dev team for a period of time.
You as a Platform Engineer will put on your SRE hat and work alongside the developer team in their everyday challenges.</li>
<li>Read about and learn from some of the great models of empathy, such as Jesus of Nazareth (e.g. in the first four books of the New Testament), the God who became human (this allowed Him to empathize more with us, but also us to empathize more with Him).</li>
</ul>
<h3 id="practicing-writing">Practicing Writing
</h3><p>Everyone at work communicates all the time.
Working remotely has forced us to do so in more written form than ever before &mdash; and I think this is a good thing overall!
Sure, it&rsquo;s faster to work together in the office, where it&rsquo;s super easy to quickly ask questions and show things, but asynchronous written communication is much more inclusive and promotes transparency.</p>
<p>There are many ways to improve your written communication (e.g. <a class="link" href="https://nohello.net" target="_blank" rel="noopener"
>don&rsquo;t make people wait</a>).
Your written communication will always be better the more you <em>empathize</em> with the other person(s) (see previous point).
Still, you can practice the following skills to improve your writing in chats:</p>
<ol>
<li>Write <strong>complete sentences</strong> by default.</li>
<li>Adhere to <strong>basic grammar and syntax</strong> (just as you would when writing code).
<ul>
<li>You can use AI assistance for this like <a class="link" href="https://www.deepl.com/de/write" target="_blank" rel="noopener"
>DeepL Write</a>.
(Hint: I refined this blog post using DeepL Write.)</li>
</ul>
</li>
<li>Write <strong>short and clear sentences</strong>.
<ul>
<li>If your message gets longer, use bullets and headings to break your message into more readable chunks.</li>
<li>Familiarize yourself with the <strong>formatting options</strong> your chat tool offers.
Some tools allow Markdown, for example.</li>
</ul>
</li>
<li><em>In group chats</em> (i.e. when communicating with several people at once):
<ol>
<li>Avoid using <strong>literal backreferences</strong> (&ldquo;this thing&rdquo;, &ldquo;that&rdquo;).
Use the &ldquo;reply to&rdquo; feature (or better yet, if available, start a <strong>thread</strong>) to maintain/restore context.</li>
<li>Use @-<strong>mentions</strong> to notify a subset of people in the current chat, if your message does not address everyone.</li>
</ol>
</li>
</ol>
<p>In the spirit of SRE and <a class="link" href="https://www.learningfromincidents.io" target="_blank" rel="noopener"
>Learning From Incidents</a>, we can also look back at past communications and learn from them.
Feel free to try these steps as an example:</p>
<ol>
<li>Search through your chat history, especially group chats where there are a lot of people and a lot of communication.</li>
<li>Try to find situations where misunderstandings occurred.
Pick a situation and think about the following questions:
<ol>
<li>What were the basic assumptions that the different people involved had?</li>
<li>To what extent were the different mental models of these people wrong? Why?</li>
<li>How could the mismatch between mental model and reality have been uncovered earlier?</li>
</ol>
</li>
</ol>
<h3 id="low-friction-editing">Low-Friction Editing
</h3><p>Now we turn briefly to the tool side of things:
If you do not make editing pages and creating documents <em>as fast and convenient as possible</em>, you will frustrate people and lose potential editors.
Those editors could be people on the platform team <em>and</em> on the development teams!</p>
<p>I see this as a very limiting factor when trying to choose a documentation tool.
One category of documentation tools I have specifically avoided <em>for internal development platforms</em> are <em>Static Site Generators (SSGs) fed from a Git repo</em>.</p>
<p>Let me be clear about this:
I am a huge fan of Git!
<a class="link" href="https://www.linkedin.com/feed/update/urn:li:activity:7120420743795892225" target="_blank" rel="noopener"
>My writing a book about GitOps</a> should leave no doubt about that.
But even if you have a template where editing any single page is just a click away <em>and</em> you link directly to a web IDE <em>and</em> you can enable automerge on the instantly created feature branch, you still have to wait for a green build to pass.
(Allowing commits directly to the default branch would be careless, because it might break the build &mdash; and you will never get around waiting for the build pipeline on the default branch anyway).
And that wait is (I think) still way too long, and makes the barrier to contributing way too high.</p>
<p>My current preference is Confluence Cloud (Cloud, not self-hosted!), but my experience is very limited.
Please send suggestions!</p>
<h3 id="a-culture-of-contributing">A Culture of Contributing
</h3><p>Whenever I see organizations talking about <em>approval processes in documentation tools</em>, I get sad.
Because sure enough, they will get exactly what they asked for:
Documentation that is picture perfect and set in stone &mdash; it cannot be changed unless you explicitly ask for permission.
But at the same time they <strong>lose everything that makes documentation valuable</strong>:</p>
<ul>
<li>Documentation becomes <strong>outdated</strong> extremly quickly because you cannot live a <em>Culture of Contributing</em>.</li>
<li><strong>RBAC</strong> becomes difficult, and those who maintain it may not always be available.
This will make even users who have permission to edit and manage certain parts of the content to feel reluctant to write shareable documentation instead of directly responding to requests.</li>
<li>People will <strong>always make direct requests</strong> because they can get a faster response.
<ul>
<li>They may <em>not always</em> get it faster because everyone is busy, but by texting a human you at least have a small chance that someone will respond faster than you will find something in the potentially outdated docs.</li>
</ul>
</li>
<li>When documentation becomes outdated and permissions are complex to obtain, you end up with <em>shadow documentation</em> (e.g. in Word documents on shared drives) or (by default and by far the worst) <em>no documentation at all</em> happens and <strong>valuable knowledge is lost</strong>.</li>
</ul>
<p>I have never seen an organization suffer from vandalism or other malicious overuse of documentation tools.
The only organizations I have encountered are those with typical people who are just trying to do their jobs well and are naturally reluctant to write anything down unless they are forced to.</p>
<p>For this reason, I believe that <strong>documentation tools should be configured with maximum editability</strong> to encourage a Culture of Contributing.
You may want to disable deletion and only allow archiving to protect content from disappearing accidentally, but otherwise everything should be as <em>welcoming</em> towards contributions as possible!
Choose a tool that allows versioning / page history so that you can revert to a known good state if any unwanted changes are made.</p>
<h2 id="documentation-devices-for-platform-engineers">Documentation Devices for Platform Engineers
</h2><p>I have identified a few types of technical documentation that, in my experience, are particularly valuable in the context of Platform Engineering:</p>
<ol>
<li>Runbooks
<ul>
<li>By giving step-by-step instructions you enable people to perform certain typical actions themselves.
For an example of a very simple runbook, see the list at the end of <a class="link" href="#practicing-writing" >Practicing Writing</a>.</li>
<li>If the amount of code snippets in a runbook gets too large, you might consider writing a script, putting it into a Git repo and creating an automated runbook that can be triggered by any user through a manual pipeline.</li>
</ul>
</li>
<li><a class="link" href="https://adr.github.io" target="_blank" rel="noopener"
>Architectural Decision Records</a> (ADRs)
<ul>
<li>This is in the spirit of HDIMSATT (see <a class="link" href="#practicing-communication" >Practicing Communication</a>) and allows you to foster collaboration and structured discussion around important technical decisions.</li>
<li>It allows you to better understand the assumptions and constraints that were in place at the time.
When you return later, you can re-evaluate whether those assumptions still hold true and revisit the decision in light of new constraints.
(Remember to create another ADR for the new decision you take.)</li>
</ul>
</li>
<li><a class="link" href="https://app.diagrams.net" target="_blank" rel="noopener"
>draw.io</a> or <a class="link" href="https://mermaid.js.org" target="_blank" rel="noopener"
>Mermaid</a> for diagrams
<ul>
<li>Many documentation tools come with integrations for these.</li>
</ul>
</li>
</ol>
<p>In addition, there are also overarching documentation frameworks such as <a class="link" href="https://arc42.org/overview" target="_blank" rel="noopener"
>arc42</a>.
At <a class="link" href="https://www.mimacom.com" target="_blank" rel="noopener"
>Mimacom</a>, we have used arc42 in several projects and found the structure very helpful.
To keep the momentum though, don&rsquo;t think too much about which section a single page belongs to; you can always restructure later after writing your current piece of content.
Fortunately, there are <a class="link" href="https://arc42.org/download" target="_blank" rel="noopener"
>downloads available</a> for Asciidoc, Markdown, LaTeX, and a few other formats.</p></description></item><item><title>Eine neue Psalmen-Liturgie</title><link>https://jscheytt.github.io/p/eine-neue-psalmen-liturgie/</link><pubDate>Sat, 21 Oct 2023 13:28:49 +0200</pubDate><guid>https://jscheytt.github.io/p/eine-neue-psalmen-liturgie/</guid><description><p><em>In diesem Post stelle ich eine 2-Wochen-Liturgie basierend auf den Psalmen vor.
Dieses Stundengebet verwende ich selbst privat; es ist aber durchaus für den Gebrauch in Gemeinschaften gedacht, die das Leben im Reich Gottes einüben wollen.</em></p>
<p><strong>Wenn du die Hintergründe überspringen willst, spule direkt vor zur <a class="link" href="#die-liturgie" >eigentlichen Liturgie</a>.</strong></p>
<p>Die Psalmen sind ein besonderer Schatz in der Bibel, sind sie doch gleichzeitig das Wort Gottes und Worte von Menschen.
Mithilfe dieser verschriftlichen Gespräche mit Gott, die Menschen lange vor uns geführt und festgehalten haben, haben wir eine extrem praktische Hilfe, um unser ganzes Innenleben vor Gott auszubreiten und dadurch Beziehung zu Ihm zu führen.</p>
<p>Vor einigen Jahren habe ich angefangen, diesen Schatz bewusst zu entdecken und in meinen eigenen Gebetszeiten zu verwenden.
Da ich sowieso meine Beziehung zu Gott viel dadurch führe, dass ich Sein Wort verwende (vor allem durch lautes Lesen und Auswendiglernen), fiel mir das nicht sonderlich schwer.
Ich begann mit einer fortlaufenden Lesung (&ldquo;Lectio continua&rdquo;), bei der ich mit Psalm 1 begann, am nächsten Tag Psalm 2 las, am nächsten Tag Psalm 3 und so weiter, bis ich nach Psalm 150 wieder von vorne anfing.</p>
<p>So ging es mehrere Jahre, bis ich merkte, dass ich einen Stopp oder eine Veränderung brauchte, um nicht betriebsblind für die Inhalte der Psalmen zu werden.
Ich wusste nicht, wie eine gesunde Alternative zur Lectio continua aussehen könnte, aber ich pausierte mein kontinuierliches Psalmengebet und suchte nun nach neuen Möglichkeiten, mit dem ganzen Psalter in meinem Alltag zu beten.</p>
<h2 id="stundengebete">Stundengebete
</h2><p>Durch verschiedene Ansatzpunkte und Gespräche mit Freunden traf ich auf Stundengebete.
Damit sind Gebetsformen gemeint, bei denen man (ähnlich der rituellen Gebetszeiten der Muslime) zu mehreren festgelegten Zeiten am Tag betet, oftmals mit vorformulierten Gebeten.
Das fand ich ansprechend, da ich von meiner Persönlichkeit her sehr strukturiert bin und gleichzeitig immer mehr lernen will, in meinem <em>ganzen</em> Alltag mit Gott verbunden zu sein.</p>
<p>Leider waren die ersten Gebetsbücher mit vorformulierten Gebeten, auf die ich traf, für meinen Geschmack zu einseitig und zu wenig auf Gott beziehend.
Durch Gottes Gnade landete ich irgendwann beim Mönchstum und fand einen Orden, deren Gebetsbuch zum Haupteil aus den Psalmen besteht.</p>
<p>Dieser Orden sind die <strong><a class="link" href="https://de.wikipedia.org/wiki/Benediktiner" target="_blank" rel="noopener"
>Benediktiner</a></strong>, einer der weltweit größten Mönchsorden, beheimatet in der katholischen Kirche und benannt nach ihrem Gründer Benedikt von Nursia (6. Jahrhundert).
In der <a class="link" href="https://de.wikipedia.org/wiki/Stundengebet#Benediktsregel" target="_blank" rel="noopener"
>Ordensregel</a> schreibt der Heilige Benedikt seinen Ordensbrüdern vor, dass sie <a class="link" href="https://www.intratext.com/IXT/DEU0017/_PJ.HTM" target="_blank" rel="noopener"
>einmal in der Woche den ganzen Psalter durchbeten sollen</a> - jede Woche in jedem Jahr.
In dieser Regel sind auch <a class="link" href="http://individual.utoronto.ca/aaronorear/psalmody.html" target="_blank" rel="noopener"
>einige konkrete Aufteilungen</a> der Psalmen auf Wochentage und Gebetszeiten enthalten, worauf Benedikt allerdings nicht streng beharrt (siehe <a class="link" href="https://www.intratext.com/IXT/DEU0017/_PJ.HTM" target="_blank" rel="noopener"
>RB 18,20</a>).
Ebenso schreibt die Benedikts-Regel <a class="link" href="https://www.intratext.com/IXT/DEU0017/_PH.HTM" target="_blank" rel="noopener"
>sieben tägliche Gebetszeiten</a> vor (wobei die meisten heutigen Klöster nur 4 - 5 Gebetszeiten ausüben, indem sie einige der vorgeschriebenen Zeiten kombinieren).</p>
<h2 id="benediktinische-psalmenliturgie">Benediktinische Psalmenliturgie
</h2><p>Eines der bekannteren Benediktinerklöster in Deutschland steht in Münsterschwarzach.
Bekannt ist es unter anderem durch den schriftstellerisch sehr aktiven und dort ansässigen Benediktinermönch Anselm Grün.
Was ebenfalls von dort stammt, ist das &ldquo;<strong><a class="link" href="https://www.vier-tuerme.de/benediktinisches-antiphonale-komplettpaket-mit-baenden-i-bis-iii" target="_blank" rel="noopener"
>Benediktinische Antiphonale</a></strong>&rdquo;, ein mehrbändiges Gebetsbuch mit fast 2.000 Seiten.
Dieses Gebetsbuch enthält eine Liturgie, bei der alle Psalmen in einer sorgfältig aufeinander abgestimmten Reihenfolge zusammengestellt und mit gottesdienstlichen Elementen aus der katholischen Tradition verwoben sind.
Die liturgische Zusammenstellung aus diesem Kloster wird mittlerweile in vielen deutschsprachigen Benediktinerklöstern verwandt.</p>
<p>Nicht nur die Positionierung der Psalmen ist in diesem Fall besonders (wir betrachten gleich genauer, warum), sondern auch der Text:
Auch wenn die Mönche ihrer Kirche treu sein und die Einheitsübersetzung verwenden wollten, taten sie sich doch sehr schwer damit, weil sie so wenig singbar war.
Deswegen entschlossen sich einige Benediktiner aus verschiedenen Klöstern, gemeinsam eine <strong>komplett eigene Übersetzung der Psalmen aus dem hebräischen Urtext</strong> zu erstellen.
Diese Neuübersetzung sollte einerseits der poetischen Form der Psalmen Rechnung tragen (durch Klarheit, Kürze und Sprachrhythmus) und sich andererseits auch für ihren gregorianischen Gesang im Kloster eignen.
Diese Übersetzung der Psalmen, deren Redaktion in Münsterschwarzach stattfand, ist mittlerweile auch getrennt von der restlichen Liturgie erhältlich als &ldquo;<em><a class="link" href="https://www.bookfinder.com/isbn/9783878682363/?st=sr&amp;ac=qr&amp;mode=basic&amp;author=&amp;title=&amp;isbn=9783878682363&amp;lang=de&amp;destination=de&amp;currency=EUR&amp;binding=*&amp;keywords=&amp;publisher=&amp;min_year=&amp;max_year=&amp;minprice=&amp;maxprice=" target="_blank" rel="noopener"
>Münsterschwarzacher Psalter</a></em>&rdquo;.</p>
<p>Bei der Zusammenstellung der Psalmen gingen die Mönche (darunter sticht am meisten <a class="link" href="https://de.wikipedia.org/wiki/Notker_F%C3%BCglister" target="_blank" rel="noopener"
>Notker Füglister</a> hervor) mit tiefem Verständnis von Literatur und großer Liebe zu Gott und Seinem Wort vor:</p>
<ol>
<li>Sie ordneten die Psalmen (so weit möglich) bestimmten <strong>Tageszeiten</strong> zu. Beispiele:
<ul>
<li>Psalm 5 &ldquo;Am Morgen wirst du mein Rufen hören&rdquo; für morgens</li>
</ul>
</li>
<li>Sie setzten sie auch bewusst an bestimmte <strong>Wochentage</strong>. Beispiele:
<ul>
<li>Messianische Psalmen (z. B. Psalm 2) an die Sonntage</li>
<li>Psalm 22 &ldquo;Mein Gott, mein Gott, warum hast du mich verlassen?&rdquo; an den Freitagmittag (wegen Karfreitag)</li>
</ul>
</li>
<li>Ihrer Ansicht nach stehen <strong>alle Psalmen in Beziehung zueinander</strong> und &ldquo;sind miteinander im Gespräch&rdquo;. Beispiele:
<ul>
<li>Psalm 100 und 95 stehen fast benachbart in einer Gebetszeit und enthalten beide die Zeile &ldquo;Wir sind das Volk Deiner Weide, die Herde Deiner Hand&rdquo;.</li>
<li>Psalm 58 und 82 stehen benachbart und klagen ungerecht handelnde Mächtige an.</li>
<li>Psalm 29, 1 und 19 stehen zusammen und bestaunen Gottes Reden und Sein Gesetz.</li>
</ul>
</li>
<li>Jeder Psalm wurde <strong>am Stück</strong> gebetet und nicht in einzelne Versabschnitte zerstückelt
<ul>
<li>Einzige Ausnahme ist Psalm 119, den mit Abstand längsten Psalm, der allerdings natürlicherweise aus 22 Strophen besteht.</li>
</ul>
</li>
</ol>
<p>Weiterhin machten die Mönche an manchen Stellen Vereinfachungen bei der <strong>Zählung und Aufteilung der Psalmen</strong>:</p>
<ul>
<li><strong>Drei Psalmen werden ausgelassen</strong>, weil sie vollständig in anderen Psalmen enthalten sind:
<ul>
<li>Psalm 53 = Psalm 14</li>
<li>Psalm 70 = Psalm 40,14-18</li>
<li>Psalm 108 = Psalm 57,8-12 = Psalm 60,7-14</li>
</ul>
</li>
<li>Manche Psalmen werden <strong>zusammengefasst</strong>:
<ul>
<li>Psalm 9 und 10 sind einer der alphabetischen Psalmen, bei denen jeder Vers (oder jeder x-te Vers) mit dem nächsten Buchstaben des hebräischen Alphabets beginnt, sodass 9 und 10 generell als Einheit betrachtet werden.</li>
<li>Psalm 42 und 43 haben einen identischen Refrain und werden ebenfalls als Einheit betrachtet.</li>
</ul>
</li>
<li><strong>Psalm 119</strong> als der längste Psalm besteht aus 22 Strophen und wird nicht komplett am Stück gelesen.
Stattdessen werden die einzelnen Strophen an bestimmten Stellen in der Liturgie als sogenanntes &ldquo;Responsorium&rdquo; eingebaut.
(Ich konnte leider nicht genauer herausfinden, wo sie eingebaut wurden und ob es dabei irgendein bewusstes Muster gab.)</li>
</ul>
<h2 id="eine-eigene-liturgie-entsteht">Eine eigene Liturgie entsteht
</h2><h3 id="antiphonale-brevier-psalter">Antiphonale, Brevier, Psalter
</h3><p>Dank der Unibibliothek in unserer Nähe konnte ich sowohl den Münsterschwarzacher Psalter als auch eine Kurzfassung des Antiphonale, das &ldquo;<a class="link" href="https://www.bookfinder.com/isbn/9783736501263/?st=sr&amp;ac=qr&amp;mode=basic&amp;author=&amp;title=&amp;isbn=9783736501263&amp;lang=de&amp;destination=de&amp;currency=EUR&amp;binding=*&amp;keywords=&amp;publisher=&amp;min_year=&amp;max_year=&amp;minprice=&amp;maxprice=" target="_blank" rel="noopener"
>Benediktinische Brevier</a>&rdquo; ausleihen.
Das Brevier enthält alle Liturgieteile außer die Vigilien (die Vigil ist die allererste Gebetszeit).
Die Vigilien enthalten allerdings 54 Psalmen; dadurch fehlt im Brevier mehr als ein Drittel aller Psalmen.</p>
<p>Dennoch konnte ich mithilfe des Breviers auch ohne direkten Zugriff auf ein Kloster oder Mönche die Antiphonale-Liturgie in ihrer Vollständigkeit ausprobieren.
Kurz gesagt war es als Nichtkatholik zu viel Neues für mich, auch wenn sie sehr viele wertvolle Elemente enthält wie schriftbasierte Gesänge, Schuldbekenntnisse und Fürbitte.
Spannenderweise sind für hohe Feiertage besondere Zusatztexte oder Abweichungen im Ablauf vorgesehen, was wiederum zeigt, aus welch reichem Schatz an Tradition und Kirchengeschichte die Mönche schöpfen.</p>
<p>Im Münsterschwarzacher Psalter hingegen fand ich dann zum ersten Mal eine Kurzbeschreibung der Psalmenaufteilung des Benediktinischen Antiphonale.
Die Aufteilung ist wie folgt:</p>
<table>
<thead>
<tr>
<th>Wochentag</th>
<th>Vigil Inv.</th>
<th>Vigil I</th>
<th>Vigil II</th>
<th>Laudes</th>
<th>MH I</th>
<th>MH II</th>
<th>Abendhore</th>
<th>Nachthore</th>
</tr>
</thead>
<tbody>
<tr>
<td>Sonntag</td>
<td>81</td>
<td>110</td>
<td>45</td>
<td>93</td>
<td>118</td>
<td>136</td>
<td>113</td>
<td>4</td>
</tr>
<tr>
<td></td>
<td></td>
<td>18</td>
<td>9/10</td>
<td>3</td>
<td></td>
<td></td>
<td>114</td>
<td>91</td>
</tr>
<tr>
<td></td>
<td></td>
<td>2</td>
<td>72</td>
<td>30</td>
<td></td>
<td></td>
<td>115</td>
<td>134</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td>147</td>
<td></td>
<td></td>
<td>116</td>
<td></td>
</tr>
<tr>
<td>Montag</td>
<td>29</td>
<td>1</td>
<td>94</td>
<td>100</td>
<td>25</td>
<td>120</td>
<td>33</td>
<td>34</td>
</tr>
<tr>
<td></td>
<td></td>
<td>104</td>
<td>105</td>
<td>63</td>
<td></td>
<td>121</td>
<td>61</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td>71</td>
<td>112</td>
<td>101</td>
<td></td>
<td>122</td>
<td>28</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td>135</td>
<td></td>
<td></td>
<td>48</td>
<td></td>
</tr>
<tr>
<td>Dienstag</td>
<td>67</td>
<td>6</td>
<td>74</td>
<td>98</td>
<td>42/43</td>
<td>123</td>
<td>75</td>
<td>139</td>
</tr>
<tr>
<td></td>
<td></td>
<td>107</td>
<td>73</td>
<td>90</td>
<td></td>
<td>124</td>
<td>140</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td>7</td>
<td>77</td>
<td>65</td>
<td></td>
<td>125</td>
<td>26</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td>117</td>
<td></td>
<td></td>
<td>145</td>
<td></td>
</tr>
<tr>
<td>Mittwoch</td>
<td>46</td>
<td>78</td>
<td>58</td>
<td>97</td>
<td>44</td>
<td>126</td>
<td>103</td>
<td>32</td>
</tr>
<tr>
<td></td>
<td></td>
<td>132</td>
<td>19</td>
<td>36</td>
<td></td>
<td>127</td>
<td>86</td>
<td>62</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td>49</td>
<td>57</td>
<td></td>
<td>128</td>
<td>85</td>
<td>133</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td>82</td>
<td>149</td>
<td></td>
<td></td>
<td>87</td>
<td></td>
</tr>
<tr>
<td>Donnerstag</td>
<td>24</td>
<td>39</td>
<td>50</td>
<td>47</td>
<td>55</td>
<td>129</td>
<td>11</td>
<td>102</td>
</tr>
<tr>
<td></td>
<td></td>
<td>37</td>
<td>68</td>
<td>76</td>
<td></td>
<td>130</td>
<td>23</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td>41</td>
<td>83</td>
<td>5</td>
<td></td>
<td>131</td>
<td>84</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td>148</td>
<td></td>
<td></td>
<td>40</td>
<td></td>
</tr>
<tr>
<td>Freitag</td>
<td>8</td>
<td>88</td>
<td>60</td>
<td>96</td>
<td>22</td>
<td>11</td>
<td>144</td>
<td>31</td>
</tr>
<tr>
<td></td>
<td></td>
<td>69</td>
<td>106</td>
<td>143</td>
<td></td>
<td>12</td>
<td>141</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td>38</td>
<td>79</td>
<td>64</td>
<td></td>
<td>13</td>
<td>142</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td>146</td>
<td></td>
<td></td>
<td>27</td>
<td></td>
</tr>
<tr>
<td>Samstag</td>
<td>95</td>
<td>59</td>
<td>137</td>
<td>99</td>
<td>35</td>
<td>52</td>
<td>66</td>
<td>15</td>
</tr>
<tr>
<td></td>
<td></td>
<td>109</td>
<td>89</td>
<td>51</td>
<td></td>
<td>14</td>
<td>20</td>
<td>16</td>
</tr>
<tr>
<td></td>
<td></td>
<td>56</td>
<td>80</td>
<td>92</td>
<td></td>
<td>54</td>
<td>21</td>
<td>17</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td>150</td>
<td></td>
<td></td>
<td>138</td>
<td></td>
</tr>
</tbody>
</table>
<p>In dieser Zusammenstellung sind die Psalmen verteilt auf fünf Gebetszeiten:</p>
<ol>
<li>Vigil mit Invitatorium und Teil I (in 1. Wochen) oder Teil II (in 2. Wochen)
<ul>
<li>Meist um 05:30</li>
<li>In einigen Klöstern folgt die Laudes direkt im Anschluss auf die Vigil.</li>
</ul>
</li>
<li>Laudes</li>
<li>Mittagshore (abgekürzt mit &ldquo;MH&rdquo;) mit Teil I (in 1. Wochen) oder Teil II (in 2. Wochen)
<ul>
<li>Meist um 12:00</li>
</ul>
</li>
<li>Abendhore (auch &ldquo;Vesper&rdquo;)
<ul>
<li>Meist um 17:30</li>
<li>Das Wort &ldquo;Hore&rdquo; bedeutet wörtlich &ldquo;Stunde&rdquo; (wie engl. &ldquo;hour&rdquo;) und steht für eine einzelne Gebetszeit.</li>
</ul>
</li>
<li>Nachthore (auch &ldquo;Komplet&rdquo;)
<ul>
<li>Meist um 19:00</li>
</ul>
</li>
</ol>
<p>Ursprünglich hatte ich fälschlicherweise angenommen, dass Vigil I/II und Mittagshore I/II immer zusammen gebetet werden.
Erst bei einem kürzlichen Besuch in einem Kloster stellte ich meinen Irrtum fest:
Es werden alternierend Vigil I mit Mittagshore I und in der anschließenden Woche Vigil II mit Mittagshore II gebetet, während die restlichen Elemente gleich bleiben.
Dadurch werden doch nicht alle Psalmen in exakt einer Woche gebetet; es sind durchschnittlich 110 Psalmen pro Woche (also ungefähr 75 %).</p>
<h3 id="ziele-und-gestaltungsprinzipien">Ziele und Gestaltungsprinzipien
</h3><p>Mit dieser obigen Tabelle hatte ich einen extrem wertvollen Startpunkt für eine eigene Liturgie.
Bei der Gestaltung dieser Psalmenliturgie waren mir folgende Dinge besonders wichtig:</p>
<ol>
<li>Der Psalter soll mit <strong>vertretbarem Zeitaufwand</strong> nutzbar sein, sowohl für Einzelpersonen als auch für geistliche Gemeinschaften, die täglich gemeinsame Gebetszeiten pflegen wollen.
<ol>
<li>Deswegen habe ich ihn auf <strong>zwei Wochen</strong> verteilt.
<ul>
<li>Grobe Rechnung dazu:</li>
<li>Bei 145 Psalmen (siehe die obigen Auslassungen) und 14 Tagen kommt man auf 10 bis 11 Psalmen am Tag.</li>
<li>In der Audioversion der &ldquo;Hoffnung für alle&rdquo; dauern die Psalmen in Summe ziemlich genau sechs Stunden.
Damit sind wir bei durchschnittlich ca. <em>25 Minuten reiner Lesezeit pro Tag</em>.</li>
</ul>
</li>
<li>Ebenfalls aus Gründen der Machbarkeit habe ich <strong>drei Horen</strong> gewählt:
Morgen, Mittag, Abend.
<ul>
<li>Die Mittagshore soll kürzer sein, weil in Gemeinschaften womöglich nicht alle Mitglieder mittags anwesend sein können.</li>
<li>Bei drei Horen und zwei Wochen ergibt sich eine Psalmenanzahl von durchschnittlich <em>3 - 4 Psalmen pro Hore</em>.</li>
</ul>
</li>
<li>Außerdem sollen die <strong>Horen ungefähr gleich lang</strong> sein für bessere Planbarkeit und um Zeitdruck zu vermeiden.
<ul>
<li>Als Ausnahme können die Horen an Samstagen und Sonntagen länger sein, weil wir hier davon ausgehen können, dass wir mehr Zeit zur Verfügung haben.</li>
</ul>
</li>
</ol>
</li>
<li><strong>Biblische Texte</strong> sollen die Grundlage bilden.
Bei außerbiblische Gebeten haben wir eine zu schwer überschaubare Auswahl.</li>
<li>Die <strong>Anordnung der Psalmen</strong> zueinander aus dem Antiphonale soll so weit wie möglich <strong>erhalten</strong> bleiben, um aus dem reichen Erfahrungsschatz der benediktinischen Mönche zu schöpfen.</li>
<li>Als Ergänzung sollen auch <strong>neutestamentliche Texte</strong> mit einfließen.
Nur Psalmen zu lesen ohne den Bezug zu Christus ist auf Dauer unausgewogen.</li>
<li><strong>Psalm 119</strong> soll am Ende der Morgen- und Mittagshoren stehen.
Damit können wir zum Start in den Vormittag und dann zum Start in den Nachmittag jeweils bekräftigen, dass wir unter Jesu Herrschaft und im Einklang mit Seinem Willen leben möchten.
<ul>
<li>Zu Psalm 119 habe ich ein <a class="link" href="https://jscheytt.github.io/p/the-beauty-of-the-law/" >besonderes Verhältnis</a>.</li>
</ul>
</li>
</ol>
<h3 id="erste-schritte">Erste Schritte
</h3><p>Die Umstrukturierung des Antiphonale begann anfänglich mit Fokus auf der Umverteilung der fünf bestehenden Horen auf die drei neuen Horen:</p>
<ul>
<li>Die <em>neue Laudes</em> nimmt die originale Laudes und von den Vigilien das Invitatorium und Teil I.
<ul>
<li>Die Vigil und die Laudes des Sonntags blieb an ihrem Platz (die Laudes an Sonntag I, die Vigil an Sonntag II).</li>
<li>An den anderen Tagen wechseln sich Laudes und Vigil Inv+I ab.
(Dieses Abwechseln hat sich insgesamt bewährt, damit vollständig erhaltene Segmente aus dem Antiphonale sich abwechseln können mit stärker umsortierten Horen.)</li>
</ul>
</li>
<li>Die <em>neue Mittagshore</em> nimmt die originale Mittagshore I und II und den Sonntag, Montag und Dienstag der Vigil II.</li>
<li>Die <em>neue Abendhore</em> nimmt die originale Abendhore, Nachthore und Mittwoch bis Samstag (die übrigen Tage) der Vigil II.</li>
<li>Jede Hore besteht aus drei Teilen:
<ol>
<li>Ein oder mehrere Psalmen als Hauptteil</li>
<li>Eine Schriftlesung aus dem Neuen Testament</li>
<li>Ein Abschlusspsalm</li>
</ol>
</li>
</ul>
<p>Als ich eine erste Version zusammengebaut hatte, testete ich sie umgehend im Alltag.
Über viele Wochen hinweg verfeinerte ich die Zusammenstellung an vielen Stellen:</p>
<ul>
<li><a class="link" href="https://docs.google.com/spreadsheets/d/14AuC6JHy1GkDbFyaH_jHxm-OzG-m8ZMW?rtpof=true" target="_blank" rel="noopener"
>Dank Excel</a> konnte ich den Mittelwert und die Standardabweichung der Leselängen der einzelnen Horen bestimmen.
Dadurch konnte ich diese Werte in immer besseres Fahrwasser bringen für eine möglichst einheitliche Länge.</li>
<li>Die Aufteilung der 22 Strophen von Psalm 119 war anfänglich auf allen Morgenden und Mittagen und zusätzlich auf dem Samstagmorgen.
Allerdings waren einige der späteren 119-Strophen inhaltlich besser für den Abend bzw. Morgen geeignet.
Deswegen sortierte ich sie um, sodass der Samstag I jetzt keine 119-Strophen mehr enthält, aber dafür der Samstag II.</li>
<li>Für die NT-Texte nutzte ich die Texte, die bereits im Antiphonale vorkamen und einige NT-Texte, die uns als Hauskreis wichtig sind.</li>
<li>Manche Konstellationen von Psalmen waren sehr bitter und hoffnungslos.
Das darf unsere Seele auch so empfinden.
Und dennoch war bspw. Psalm 88 direkt gefolgt von Psalm 39 ziemlich heftige Kost, sodass bei einigen Morgen- und Abendhoren noch viel umsortiert wurde.</li>
<li>Der Abschlusspsalm der Abendhore ist direkt als letzte Lektüre vor dem Schlafengehen gedacht.
Nicht alle Psalmen bieten sich dafür gleich gut an.
Auch an dieser Stelle waren einige Umverteilungen angebracht.</li>
<li>Als einzige alttestamentliche Schriftlesung kam 1. Mose 2,1-3 an den Samstagabenden hinzu.
Im Judentum beginnt der neue Tag am Abend und der erste Tag der Woche ist für Christen der Sonntag.
Diese Verse aus dem Schöpfungsbericht sollen uns helfen, die neue Woche aus dem Ruhen in unserem Schöpfer zu beginnen.</li>
</ul>
<p>Nach vielen Wochen kam ich an einer Zusammenstellung an, welche die gesteckten Ziele meiner Ansicht nach gut erfüllt.</p>
<h2 id="die-liturgie">Die Liturgie
</h2><p>Keinesfalls ist diese Liturgie als ein sklavisch einzuhaltendes und lebloses Ritual zu verstehen.
Sie soll vielmehr als ein hilfreicher Bezugsrahmen dienen, der uns das Hinwenden zum unsichtbaren Gott, der sich in Jesus sichtbar gemacht hat, erleichtern kann.
Wenn sie dir oder euch dazu nicht dient, ändert sie nach Belieben ab.</p>
<p>Diese Liturgie ist grundsätzlich sehr simpel aufgebaut:</p>
<ul>
<li>Es gibt <strong>drei Gebetszeiten</strong>: Morgen, Mittag, Abend
<ul>
<li>Gemäß der monastischen Tradition nennen wir sie <em>Laudes</em> (&ldquo;Lobgesänge&rdquo;), Mittagshore und Abendhore.</li>
<li>In der Tabelle sind sie bezeichnet mit &ldquo;L&rdquo;, &ldquo;M&rdquo; und &ldquo;A&rdquo;.</li>
</ul>
</li>
<li>Jede Gebetszeit (Hore) besteht aus <strong>drei Teilen</strong>:
<ol>
<li>Psalmen (Teil 1)</li>
<li>Lesung aus dem Neuen Testament (Teil NT)</li>
<li>Abschlusspsalm (Teil 2)</li>
</ol>
</li>
<li>Die Bibeltexte sind über <strong>zwei Wochen</strong> verteilt.</li>
<li>Kleine Besonderheiten:
<ul>
<li>Psalm 119 besteht aus 22 Strophen und wird nie am Stück gelesen.
Stattdessen sind die einzelnen Strophen über die zwei Wochen verteilt.</li>
<li>Einige Psalmen (53, 70, 108) fehlen, weil sie vollständig in anderen Psalmen enthalten sind (siehe <a class="link" href="#benediktinische-psalmenliturgie" >Benediktinische Psalmenliturgie</a>).</li>
<li>Die Samstage enthalten nach dem Abschlusspsalm noch einen Abschnitt aus 1. Mose, um die neue Woche aus Gottes Schöpfungsruhe heraus zu beginnen.</li>
</ul>
</li>
</ul>
<p>Die Psalmen und NT-Texte teilen sich folgendermaßen auf:</p>
<table>
<thead>
<tr>
<th>Wochentag</th>
<th>L 1</th>
<th>L NT</th>
<th>L 2</th>
<th>M 1</th>
<th>M NT</th>
<th>M 2</th>
<th>A 1</th>
<th>A NT</th>
<th>A 2</th>
</tr>
</thead>
<tbody>
<tr>
<td>Sonntag I</td>
<td>93</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/Joh1,1-18" target="_blank" rel="noopener"
>Joh1,1-18</a></td>
<td>92</td>
<td>118</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/Joh17" target="_blank" rel="noopener"
>Joh17</a></td>
<td>150</td>
<td>60</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/1Joh2,28ff" target="_blank" rel="noopener"
>1Joh2,28</a>-<a class="link" href="https://www.bibleserver.com/NG%C3%9C/1Joh3,1-3" target="_blank" rel="noopener"
>3,3</a></td>
<td>116</td>
</tr>
<tr>
<td></td>
<td>3</td>
<td></td>
<td></td>
<td>136</td>
<td></td>
<td></td>
<td>113</td>
<td></td>
<td></td>
</tr>
<tr>
<td></td>
<td>30</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td>114</td>
<td></td>
<td></td>
</tr>
<tr>
<td></td>
<td>147</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td>115</td>
<td></td>
<td></td>
</tr>
<tr>
<td>Montag I</td>
<td>29</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/Mt5,17ff" target="_blank" rel="noopener"
>Mt5,17ff</a></td>
<td>119-I</td>
<td>25</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/Eph1,15ff" target="_blank" rel="noopener"
>Eph1,15ff</a></td>
<td>119-II</td>
<td>32</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/1Joh4,7ff" target="_blank" rel="noopener"
>1Joh4,7ff</a></td>
<td>139</td>
</tr>
<tr>
<td></td>
<td>1</td>
<td></td>
<td></td>
<td>120</td>
<td></td>
<td></td>
<td>62</td>
<td></td>
<td></td>
</tr>
<tr>
<td></td>
<td>19</td>
<td></td>
<td></td>
<td>121</td>
<td></td>
<td></td>
<td>133</td>
<td></td>
<td></td>
</tr>
<tr>
<td></td>
<td>71</td>
<td></td>
<td></td>
<td>122</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>Dienstag I</td>
<td>63</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/Of4" target="_blank" rel="noopener"
>Of4</a></td>
<td>119-III</td>
<td>9/10</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/Joh16,19ff" target="_blank" rel="noopener"
>Joh16,19ff</a></td>
<td>119-IV</td>
<td>33</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/Joh15,1-17" target="_blank" rel="noopener"
>Joh15,1-17</a></td>
<td>48</td>
</tr>
<tr>
<td></td>
<td>101</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td>61</td>
<td></td>
<td></td>
</tr>
<tr>
<td></td>
<td>135</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td>28</td>
<td></td>
<td></td>
</tr>
<tr>
<td></td>
<td>96</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>Mittwoch I</td>
<td>67</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/1Kor1,18ff" target="_blank" rel="noopener"
>1Kor1,18ff</a></td>
<td>119-V</td>
<td>42/43</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/2Kor5,14ff" target="_blank" rel="noopener"
>2Kor5,14ff</a></td>
<td>119-VI</td>
<td>102</td>
<td><a class="link" href="https://www.bibleserver.com/NG%C3%9C/Mt6,1-18" target="_blank" rel="noopener"
>Mt6,1-18</a></td>
<td>17</td>
</tr>
<tr>
<td></td>