Easy Agile Podcast Ep.32 Why Your Retrospectives Keep Failing (and How to Finally Fix Them)

In dieser Folge wurde ich von Sherif Mansour, Distinguished Product Manager bei Atlassian, begleitet.

Wir haben über die Stile des Produktmanagements und die Eigenschaften gesprochen, die einen großartigen Produktmanager ausmachen. Bevor wir die Idee eines gemeinsamen Gehirns und die Rolle eines Produktingenieurs erforschten.

Sherif ist seit über 15 Jahren in der Softwareentwicklung tätig. Während seiner Zeit bei Atlassian war er für Confluence verantwortlich, ein beliebtes Tool für die Zusammenarbeit von Inhalten für Teams.

In letzter Zeit verbringt Sherif die meiste Zeit damit, Probleme mit allen Cloud-Produkten von Atlassian zu lösen. Sherif spielte auch eine Schlüsselrolle bei der Entwicklung neuer Produkte wie Stride, Team Calendars und Confluence Questions bei Atlassian. Sherif ist der Meinung, dass es schwierig ist, einfache Produkte zu entwickeln, und das gilt auch für das Schreiben einer einfachen, kurzen Biographie.

Hoffe dir gefällt die Folge genauso gut wie mir. Danke für ein tolles Gespräch, Sherif.

„Es war großartig, dieses Gespräch mit Maysa führen zu können und sie ihre Geschichte erzählen zu lassen. So viele tolle Imbissbuden.“ - Nick Muldoon

Unterhalten Sie sich mit Nick Muldoon, Mitbegründer und Co-CEO von Easy Agile, mit Maysa Safadi, Engineering Manager bei Easy Agile.

Als Frau geht das Aufwachsen im Nahen Osten und die Leidenschaft für eine Karriere in der Technologiewelt nicht gerade Hand in Hand. Auf ihrem Weg durch eine sehr patriarchalische Gesellschaft spricht Maysa über ihren Werdegang und wie sie dahin gekommen ist, wo sie heute ist.

Angesichts der schlechten Chancen spricht Maysa darüber, den Status Quo in Frage zu stellen, den ständigen Druck, sich in einer von Männern dominierten Branche zu beweisen, wie wichtig es ist, den eigenen Kurs zu bestimmen und ihre Hoffnungen für die Zukunft von Frauen in der Tech-Branche.

Das ist so eine inspirierende Episode, wir hoffen, sie gefällt euch genauso gut wie uns.

Transkript

Nick Muldoon:

Hallo, Team. Nick Muldoon, Mitbegründer und Co-CEO von Easy Agile, und ich werde heute von Maysa Safadi begleitet, die als technische Leiterin hier bei Easy Agile tätig ist. Wir werden in Kürze auf Maysas Geschichte und Reise eingehen, aber zuvor wollte ich nur kurz den traditionellen Hütern des Landes, von dem aus wir heute aufnehmen und tatsächlich senden, eine kurze Anerkennung aussprechen, und das sind die Menschen des Dharawal-sprachigen Landes südlich von Sydney und Australien. Wir zollen den älteren, gegenwärtigen und aufstrebenden Ältesten unseren Respekt und zollen allen Aborigines der Torres Strait Islander und den First Nations, die sich uns heute anschließen und zuhören, denselben Respekt aus. Maysa, willkommen. Danke, dass du zu uns gekommen bist.

Maysa Safadi:

Danke, Nick. Danke, dass du mich eingeladen hast.

Nick Muldoon:

Also, Maysa ist heute dran. Wir werden Maysas bisherigen Werdegang untersuchen, und ich denke, eines der Dinge, die mich an Maysas Reise interessieren, ist, dass sie aus einer ziemlich patriarchalischen Gesellschaft im Nahen Osten stammt und viele Widrigkeiten überwunden hat, die einige ihrer Kollegen nicht überwunden haben, und sie hat es geschafft, nach Australien zu kommen, eine Familie in Australien zu gründen, hat drei wunderschöne Kinder und ist technische Managerin, nachdem sie so viele Jahre als Software gearbeitet hat. Ingenieur. Also, Maysa, ich würde gerne ein bisschen über die frühen Phasen deines Lebens erfahren und wie du zur Universität gekommen bist.

Maysa Safadi:

Ich bin in den Vereinigten Arabischen Emiraten geboren und aufgewachsen. Ich bin einer von neun. Ich habe drei Brüder und fünf Schwestern. Ich bin eigentlich das mittlere Kind. Papa und Mama, sie haben sich sehr darauf konzentriert, wirklich gute, gesunde Kinder großzuziehen, und wichtiger ist es, alle ihre Kinder zu erziehen, egal ob sie Jungen oder Mädchen sind. Ich habe dort meine Ausbildung an den Schulen begonnen. Als ich die High School abgeschlossen habe, werde ich an einem College eingeschrieben, wie man es hier in Australien nennt, TAFE.

Bildung in den Vereinigten Arabischen Emiraten ist nicht kostenlos. Ich bin einer von neun und habe das Ziel und das Ziel, dass mein Vater uns alle erzieht. Wenn es um Bildung geht, waren es zwei Faktoren, die eine große Rolle spielen. Kann Papa es sich leisten, mich auf dieses College oder diese Universität zu schicken? und wenn ich fertig bin, werde ich dann in der Lage sein, einen Job in diesem Bereich zu finden? Einer meiner Traumjobs, ich weiß noch, als ich aufgewachsen bin, wollte ich Bauingenieur werden, und ich erinnere mich, dass mein älterer Bruder, er ist der zweite, mir gesagt hat, dass es gut ist, dass du Bauingenieurwesen studieren willst. Denken Sie daran, dass Sie keinen Job finden werden.

Nick Muldoon:

Sag mir warum.

Maysa Safadi:

Vereinigte Arabische Emirate, es ist ein von Männern dominiertes Land. Der Tiefbau ist eine von Männern dominierte Branche. Wenn Sie nach einem Abschluss nach einem Abschluss nach einem Job suchen, ist dieser in erster Linie Männern und Männern aus den Emiraten vorbehalten. Also, es muss in der Warteschlange ziemlich nach unten gehen, bevor es zu mir kommt, und um realistisch zu sein, gibt man manchmal seine Träume auf, weil man weiß, dass man später im Leben keine Chance haben wird.

Nick Muldoon:

Oh mein Gott, das ist demoralisierend.

Maysa Safadi:

Unglücklicherweise.

Nick Muldoon:

Okay,

Maysa Safadi:

Die Entscheidung für mich, Ingenieurwesen zu studieren, war wiederum, dass ich nicht wirklich zur Universität gehen konnte, weil es zu teuer war. Meine ältere Schwester hatte eine Freundin, die ihr von diesem Institut erzählte, dass dort Computer unterrichtet werden. Als es um Mama und Papa ging, sagten sie uns wirklich: „Mach, was du willst, lerne, was du willst, du bist es, der im Grunde dieses Fachgebiet studieren wird, und du musst es mögen und du musst sicherstellen, dass du das Beste daraus machen kannst.“ Bei diesem Institut war es also einigermaßen in Ordnung, dass mein Vater meine Gebühren bezahlte und sie Computer unterrichteten. Ich dachte: „Ja, in Ordnung, Computer, das gehört zur Wissenschaft, oder? Ich kann vielleicht nicht Bauingenieurwesen studieren, aber ich bin wirklich sehr daran interessiert, mehr über Computer zu erfahren.“

Nick Muldoon:

Ähnlich, nah genug.

Maysa Safadi:

Nah genug. Am Ende werde ich eingeschrieben und ich erinnere mich, dass das allererste Fach Computergrundlagen oder Computergrundlagen waren, so etwas, und ich dachte: „Ja, in Ordnung, das ist interessant“, und von da an habe ich meine Ausbildung wirklich abgeschlossen. Nach zwei Jahren erhielt ich schließlich ein Diplom in Informatik.

Nick Muldoon:

Also, war das eine einzigartige Situation für dich oder gingen die meisten deiner Freundinnen von der High School auch aufs College?

Maysa Safadi:

Es ist wirklich einzigartig, einzigartig für meine Familie. Ich sage nicht, dass es selten ist, Sie werden andere Familien finden, die das tun, aber es ist nicht üblich. Es ist einzigartig, weil ja, die meisten Mädchen, wenn nicht alle, zur Schule gehen, in den Vereinigten Arabischen Emiraten Schulpflicht besteht, aber eine sehr kleine Anzahl von ihnen strebt eine höhere Bildung an. So ziemlich Mädchen, am Ende beenden sie die Schule und die allererste Chance, zu heiraten, heiraten sie und gründen ihre eigene Familie. Ich erinnere mich...

Nick Muldoon:

Und du hast einen anderen Weg gewählt, weil...

Maysa Safadi:

Oh, ja.

Nick Muldoon:

... ja, du hast heute natürlich eine Familie, aber du hast deine Karriere etabliert, du hast die Schule nicht beendet und geheiratet.

Maysa Safadi:

Ich glaube, ich gebe Mama und Papa in diesem Sinne wirklich so viel Anerkennung. Sie sagten uns, Bildung sei wichtiger als eine Familie zu gründen oder zu heiraten. Sie sagten: „Beenden Sie Ihr Studium, beenden Sie Ihre Ausbildung und dann heiraten Sie.“ Die andere Sache, die sie sagten: „Heirate nicht einmal, während du studierst, denn du wirst es mit Sicherheit nicht beenden können. Vielleicht, weil dein Mann nicht möchte, dass du es zu Ende bringst. Vielleicht beschäftigst du dich so sehr mit den Kindern und legst es zurück.“ Ich erinnere mich an so viele Male mit meinen älteren Schwestern, als jemand, es ist traditionelle Ehe, wenn einige Leute kommen und vorschlagen zu heiraten oder ihnen einen Antrag zu machen, mein Vater immer sagte: „Nein, mach zuerst deine Ausbildung zu Ende.“

Nick Muldoon:

Also, das ist interessant, weil ich glaube, dass Ihr ältester Sohn geboren wurde, als Sie sich weitergebildet und Ihren Master gemacht haben, ist das richtig?

Maysa Safadi:

Ja. Ich habe ein Diplom in Informatik. Ich wollte jedoch immer einen Bachelor-Abschluss haben. Ich wusste, dass mehr dahinter steckt. Ich habe mich in Computer verliebt, aber ich wollte mehr, und ich hatte immer diese Vorstellung im Kopf: „Wenn ich eine bessere Gelegenheit bekommen will, muss ich ein besseres Zertifikat oder eine bessere Ausbildung haben.“ Also dachte ich, ein Bachelor-Abschluss würde mir bessere Chancen geben. Ich habe in den Vereinigten Arabischen Emiraten gearbeitet und Geld gespart, und die Wollongong University hatte dort eine Niederlassung in Dubai. Also hatte ich mein Auge darauf gerichtet, dort meinen Abschluss zu machen. Schließlich schreibe ich mich an der Wollongong University auf dem Campus von Dubai ein, um meinen Bachelor-Abschluss in Informatik zu machen.

Nick Muldoon:

Also, nur für Leute, die mithören, Wollongong ist die Region Australiens, in der Maysa und ich und viele unserer Teammitglieder leben. Die University of Wollongong ist also die örtliche Wollongong University, die eine Niederlassung in Dubai hat.

Nick Muldoon:

Sie waren also an der University of Wollongong und haben diesen Bachelor-Abschluss gemacht, und wie haben Sie den Übergang und den Umzug nach Australien geschafft?

Maysa Safadi:

Als ich an der Wollongong University auf dem Campus von Dubai studierte und gleichzeitig arbeitete, um die Gebühren bezahlen zu können, traf ich meinen Mann auf der Arbeit und zufällig hat er ein qualifiziertes Migrantenvisum, um nach Australien zu kommen, zufällig. Also dachte ich: „In Ordnung, er wird nach Australien gehen, er ist eine Person, mit der ich wirklich den Rest meines Lebens verbringen werde. Also, wie wäre es, wenn ich meine Arbeiten an die Wollongong University hier in Australien übertrage und meinen Abschluss von hier aus beende, während er die Chance hat, auf dem Land zu leben, und dann können wir uns entscheiden. „Ist es ein Ort, an dem wir unser Leben hier fortsetzen können?“ Wenn nicht, war es eine gute Erfahrung. Wenn das gut ist, ist das eine weitere neue Erfahrung und Reise, die wir unternehmen werden.“ Also kommen wir am Ende nach Australien. Ich habe meinen Abschluss von hier aus gemacht.

Nick Muldoon:

Was hast du gefunden, als du in Australien ankamst? Wie unterschied es sich von den Vereinigten Arabischen Emiraten? Inwiefern war es bei Frauen anders? Inwiefern war es für Frauen im Ingenieurwesen anders, wenn man bedenkt, was Ihr Bruder über Bauingenieurwesen in Dubai gesagt hatte?

Maysa Safadi:

Ich hatte einen Kulturschock, als ich nach Australien kam. Ja, ich war in einem Land, das... ein von Männern dominiertes Land, ein Land der Dritten Welt, keine Möglichkeiten für Frauen, in einem Land, in dem alles so anders ist. Die Lebensweise, die Kommunikation, die Kultur, alles war so anders. Wenn es um Ingenieurwesen geht, weil ich mein Studium in den Vereinigten Arabischen Emiraten nicht wirklich abgeschlossen habe, also hatte ich nicht einmal die Gelegenheit, im Ingenieurwesen zu arbeiten. Da ich jedoch über das Land Bescheid wusste und wusste, wie dort Talente aufgenommen werden, wusste ich, dass ich geringe Chancen hatte. Jetzt, nach Australien zu kommen und mein Studium an der Universität abzuschließen, war eine Herausforderung. Jemand aus dem Nahen Osten, Englisch ist die zweite Sprache. Er hat einen Abschluss in Informatik und schaut sich um: „Mein Gott, wo sind die Mädchen? Ich sehe nicht wirklich viele von ihnen in der Nähe.“ Und dann, ja, in dieses Klischee von der Industrie oder von einem Bereich, in dem es nur etwas für Männer ist.

Nick Muldoon:

Ja, es kommt also ein kleiner Kulturschock rüber. Ja, schnell vorspulen, Sie haben ein Jahrzehnt in der Softwareentwicklung verbracht und sind dann in die technische Leitung aufgestiegen. Was war die Veränderung und wie haben Sie den Wandel vom Teammitglied zum Personalleiter wahrgenommen?

Maysa Safadi:

Ich habe meinen Abschluss an der Wollongong University gemacht und bekomme am Ende eine Stelle bei Motorola als diplomierter Softwareingenieur. Im gesamten Team gab es drei Frauen.

Nick Muldoon:

Wie groß war das Team?

Maysa Safadi:

Wie groß war das Team? Es waren ungefähr 20.

Nick Muldoon:

In Ordnung.

Maysa Safadi:

Jep. Da war das Netzwerkteam, ich weiß nicht mehr, wie viele, aber es war ein anderes Team. Das Team, in dem ich war, ist ein Entwicklungsteam, und da waren drei Mädchen drin, eine davon eine weitere Absolventin, die am Ende zu dem Programm kommt und eine, die ein Jahr zuvor angefangen hat. Interessant, diese beiden Frauen, sie sind nicht mehr in der IT. Ich habe es wirklich geliebt, Probleme zu lösen, ich habe es wirklich geliebt, das Ergebnis meiner Arbeit in den Händen der Leute zu sehen, weil ich Funktionen für Mobiltelefone entwickelt habe. Damals dachte ich als IC an alles, wie ich in meiner Arbeit besser werden kann, wie ich mehr lernen kann, wie ich allen beweisen kann, dass ich genauso leistungsfähig bin wie jeder andere Mann im Team.

Nick Muldoon:

Glaubst du, Maysa, dass du das im Laufe deiner Karriere tun musstest, um dich zu beweisen?

Maysa Safadi:

Ja, ja. Es ist eine schwierige Branche. Wirklich nicht so viele Frauen zu sehen, macht es schwierig, weil man nach Vorbildern sucht, die einen denken lassen: „Oh, sie hat es geschafft. Ich schaffe es. Wenn sie noch da drin ist, kann ich von ihr lernen.“ Das alles habe ich verpasst. Ich hatte in meiner Karriere nie einen anderen Mentor oder in allen Jobs, die ich zuvor hatte, auch nur eine weibliche Managerin. Also hatte ich es immer mit Männern zu tun, ich habe immer versucht, meinen Weg zu finden, um ihnen die unterschiedlichen Perspektiven zu zeigen, die ich einbringen kann. Sogar die subtilen Interaktionen, die ich früher mit ihnen hatte, gaben mir das Gefühl: „Du bist nicht fähig genug. Du bist noch nicht da. Das ist unser Gebiet. Warum bist du hier?“ All diese Dinge sinken wirklich, ohne dass Sie darüber nachdenken, Ihr Selbstwertgefühl und Ihr Selbstwertgefühl, wenn Sie in Branchen wie dieser tätig sind. Ja.

Nick Muldoon:

Also, ich bin mir bewusst, weißt du, du bist jetzt in dieser Position, du hast irgendwie darüber gesprochen, dass du nicht sein kannst, was du nicht sehen kannst. Wenn du keine Frau siehst, die eine Führungskraft hat, und du keiner unterstellst, dann ist es schwer vorstellbar, wie du das werden kannst. Aber hier sind Sie, Sie sind das geworden, und für unser Team hier sind Sie eine der weiblichen Führungskräfte im Unternehmen, was fantastisch ist. Also, ich schätze, was sind die Aktivitäten, die Sie unternehmen, um präsent zu sein und sichtbar zu machen, dass Sie eine weibliche Führungskraft im technischen Bereich sein können. Ich glaube, Anfang letzten Monats waren Sie vielleicht auf der WomenHack in Sydney.

Maysa Safadi:

Ja, ich war...

Nick Muldoon:

Was ist WomenHack?

Maysa Safadi:

In Ordnung. WomenHack, es ist eine Organisation, um verschiedene talentierte Frauen zusammenzubringen, sie zu unterstützen, sie auszubilden, und nicht nur das, um zu versuchen, sie mit anderen Unternehmen zu verbinden, die Vielfalt und Inklusion schätzen, und im Grunde versuchen, Leute einzustellen... Es geht im Grunde darum, Möglichkeiten für Frauen in der Technologiebranche zu finden, in Unternehmen, in denen sie die Vielfalt schätzen.

Nick Muldoon:

In Ordnung. Also, ich finde es interessant, ich sehe hier diese Parallelen zwischen deiner Mutter und deinem Vater, die sich aus dem Fenster gerissen haben und sich finanziell engagiert haben, um sechs Mädchen eine College- und Universitätsausbildung im Nahen Osten zu ermöglichen, und sie haben etwas getan, das zu der Zeit vielleicht ziemlich fortschrittlich war. Du sagtest, das sei nicht üblich. Es hört sich so an, als würde WomenHack heutzutage fortschrittlichere Unternehmen zusammenbringen, die Frauen Möglichkeiten bieten, in Führungspositionen zu kommen oder sogar ihre Karriere zu beschleunigen.

Maysa Safadi:

Ja, es ist so erfreulich, die Veränderung zu sehen, die sich im Laufe der Jahre vollzogen hat. Wenn ich an das Jahr 2000 zurückdenke, als ich meinen Abschluss gemacht habe und schließlich in der IT gearbeitet habe, mit all den Verhaltensweisen, da war kein Wissen oder es gab kein Bewusstsein dafür, wie wichtig Vielfalt ist, und sie waren sich nicht einmal bewusst, dass Frauen das Feld wirklich verlassen oder nicht, dass sich viele Frauen überhaupt erst in Studiengängen wie Informatik oder Ingenieurwesen einschreiben. Selbst in der Schule gab es kein Bewusstsein dafür. Dann seht ihr jetzt die Fortschritte, die in der Schule geschehen, mehr Bewusstsein findet statt. Die Universitäten versuchen, die Abschlüsse oder Fachrichtungen für Frauen und Diversität attraktiver zu gestalten. Sie versuchen, die Lücken zu überbrücken. Deshalb ergreifen viele Unternehmen Maßnahmen, um es Frauen zu erleichtern, vor Ort tätig zu sein und in diesem Bereich Fortschritte zu erzielen.

Also, WomenHack, es gibt so viele andere Gruppen wie Women in Tech, es gibt so viele Unternehmen, die ebenfalls Verbündete von Frauen in der Tech-Branche sind, wo sie versuchen, andere Unternehmen wirklich zu unterstützen und ihnen Gehör zu verschaffen. Und die gesamte Forschung und die Wissenschaft haben wirklich bewiesen, dass es für die Unternehmen, für die Teams, vorteilhafter sein wird, engagiertere Teams zu haben, die diese Unterschiede haben. Also, ja, im Moment findet eine Menge Sensibilisierung statt, und so viele Unternehmen versuchen, etwas dagegen zu unternehmen. Ich wünschte, das wäre früh gewesen.

Nick Muldoon:

Zu Beginn Ihrer Karriere.

Maysa Safadi:

Zu Beginn meiner Karriere, ja. So oft fühlte ich mich so isoliert. So oft lehnte ich mich zurück und sagte: „Ist es den Kampf wert?“ Warum muss ich immer doppelt so hart arbeiten, nur um zu beweisen, dass ich fähig bin? Warum muss das so sein? Warum bin ich nicht ebenbürtig?“ Das hat mich tatsächlich dazu gebracht, meine Karriere von IC zu People Leader zu wechseln. Ich wollte keine anderen Frauen... Leute zu führen war nicht nur etwas für Frauen, es war auch meine Aufgabe, etwas zu sagen, zu helfen. Personalleiter, um jedem vor Ort helfen zu können, unabhängig davon, ob es sich um Männer oder Frauen handelt. Moreso bedeutet, mit gutem Beispiel voranzugehen, ein Vorbild für andere zu sein, anderen zu zeigen, dass, wenn ich es schaffe, Sie es definitiv auch können, ist, Unterstützung zu bieten, dieses Vertrauen aufzubauen.

Nick Muldoon:

Also, ich denke, wie können wir uns als Branche verändern... Ich denke im Moment über den Iran nach und insbesondere über die Aktivitäten, die in den letzten 60 Tagen stattgefunden haben, aber eigentlich nur über mehr Medienberichterstattung über Hunderte von Jahren der Unterdrückung von Frauen. Was erhoffen Sie sich als Führungspersönlichkeit des Volkes, als Frau, die aus dem Nahen Osten kommt, was erhoffen Sie sich von diesen jungen Frauen und Mädchen in unserem Iran im Vergleich zu ihrer Entwicklung? Wenn wir immer noch eine Reise hierher in Australien unternehmen, in einer von Männern dominierten Branche, welche Hoffnung haben Sie in den 20 Jahren von hier bis 2040 für diese Frauen, die heute im Nahen Osten leben und immer noch keine fortschrittliche Gesellschaft gefunden haben?

Maysa Safadi:

Politik. Es ist das Machtspiel. Ich hoffe wirklich, dass diese Frauen in verschlossenen Ländern dafür sensibilisiert werden, dass es bessere Chancen für sie gibt. Sie müssen stärker sein, sie müssen sich gegenseitig unterstützen, sie müssen sich gegenseitig stärken. So leicht es auch gesagt ist, so einfach ist es nicht. All diese Frustration, die in ihnen steckt, taucht jedoch von Zeit zu Zeit auf. Ich hoffe wirklich für iranische Frauen, nicht nur für Iranerinnen, ich hoffe wirklich, dass jede Frau auf der Welt, egal ob es sich um ein Dritte-Welt-Land oder sogar um ein fortgeschrittenes Land wie Australien handelt, immer das Gefühl hat, dass sie würdig ist, dass sie immer das Gefühl hat, dass sie eine Stimme haben kann, Teil des Lebens sein kann und bedeutsame Dinge tut.

Nun, wenn sie so erzogen werden, dass ihnen immer gesagt wird, dass du an zweiter Stelle stehst, dass dir immer nur deine Rolle gesagt wird, nur um zu heiraten und eine Familie zu gründen, werden sie es selbst glauben. Es muss also von Frauen wie uns kommen, die mit gutem Beispiel vorangehen, Vorbilder sind und das Bewusstsein vermitteln. Wirklich Medien, wir müssen die Medien sehr gut nutzen, damit wir diese Menschen erreichen können, die jetzt wirklich in ihren Ländern eingesperrt sind und denken, dass das normal ist. Es muss eine Menge Arbeit geleistet werden.

Nick Muldoon:

Nun, das ist eine interessante Beobachtung. Es ist für sie normalisiert, nicht wahr? Also, wenn ich über meine eigene Erziehung nachdenke, erinnere ich mich, dass meine Eltern immer gesagt haben, du kannst alles erreichen, was du dir vorgenommen hast, aber ich könnte die Zeitung aufschlagen, ich könnte im Fernsehen schauen und ich sah eine Menge Leute, die wie ich aussahen, weiße Männer, die Australier waren, die erfolgreich im Geschäft waren, und so glaubte ich, dass ich tun und sein könnte, was ich tun und sein wollte. Also, ich schätze, wie bringen wir diese Botschaft raus? Wie erzählen wir Ihre Geschichte umfassender, um diese Botschaft zu verbreiten? Dass Sie alles tun können, was Sie sich vorgenommen haben, dass Sie alles erreichen können, was Sie sich erhoffen. Es gibt für mich etwas Interessantes an dem Medienartikel, von dem Sie sprechen, zum Nachdenken.

Maysa Safadi:

Ja, und ich denke, die Länder, in denen sie fortgeschritten sind, die Länder, in denen sie Frauen wirklich immer mehr anerkennen, sind verantwortungsbewusster, wenn es darum geht, dieses Bewusstsein zu vermitteln. Sie müssen mehr tun. Es sind im Grunde, ja, die Medien, es ist eine so wichtige Sache. Das lesen die Leute jeden Tag oder schauen sie sich jeden Tag an.

Nick Muldoon:

Ich glaube, ich bin mir dessen bewusst, als ob wir über eine halbe Welt im Nahen Osten sprechen, aber du bist hier zu Hause in einer Gemeinschaftsgruppe engagiert. In welcher Gruppe bist du engagiert und wie hilft das Frauen?

Maysa Safadi:

Ja, ich bin Vorstandsmitglied einer Organisation namens Women Illawarra. Es wird von Frauen für Frauen geführt. Im Grunde soll diese Organisation Frauen bei häuslicher Gewalt helfen, im Grunde geht es darum, sie auf den richtigen Weg zu bringen. Sie bietet ihnen Dienstleistungen und sie bildet sie aus und hilft ihnen sogar bei der Beratung, mit rechtlicher Unterstützung, damit sie aus diesen Situationen herauskommen können. Lassen Sie sie glauben, dass sie Teil dieser Gesellschaft sein können, dass sie eine wichtige Stimme in der Gesellschaft, in der Gemeinschaft sind und dass sie wirklich etwas beitragen und etwas bewirken können. Durch die Bereitstellung dieser Bildung und dieser Unterstützung werden diese Frauen in die Lage versetzt, die Dinge selbst in die Hand zu nehmen und erneut den Weg für ihr eigenes Leben und ihren eigenen Erfolg zu ebnen. Sie müssen die Kontrolle wieder übernehmen und ja, sogar ihren Kindern helfen, ihren Müttern zu zeigen, dass sie wirklich das Richtige tun.

Nick Muldoon:

Es ist dieser interessante rote Faden, der sich durch deine gesamte Lebensgeschichte und deine Reise zieht, dass Mama und Papa wollten, dass du eine Ausbildung bekommst, damit du deinen eigenen Lebensweg bestimmen kannst.

Maysa Safadi:

Ja.

Nick Muldoon:

... und hier bist du heute, gibst anderen Frauen etwas zurück und versuchst, ihnen zu helfen, eine Ausbildung zu erhalten und sich gestärkt zu fühlen, damit sie ihren eigenen Lebensweg bestimmen können. Ich finde das fantastisch. Danke, Maysa.

Maysa Safadi:

Ich danke dir.

Nick Muldoon:

Was ist Ihre Hoffnung für Frauen in den nächsten 10 Jahren? Weil es so klingt, als ob wir uns auf einem Weg befinden, in einigen Ländern machen wir Fortschritte, in anderen Ländern machen wir nicht so viele Fortschritte. Was ist Ihre Hoffnung für 2030? Wie sieht es aus?

Maysa Safadi:

Meine Hoffnung für 2030 oder meine Hoffnung für... Ich hoffe wirklich, dass es sogar fünf Jahre sind, weniger als 10 Jahre. Ich hoffe, dass in den nächsten zehn Jahren keine Gespräche darüber geführt werden, wie die Kluft zwischen Männern und Frauen verringert werden kann, denn in den nächsten zehn Jahren sollten alle so vorgehen. Ich hoffe, dass in 10 Jahren Chancengleichheit für alle besteht, unabhängig von Geschlecht, Herkunft, Sprache, körperlichen Fähigkeiten, es muss gleich sein, es muss... Gerechtigkeit, das ist eine so wichtige Sache. Es ist so wichtig, die gleichen Chancen zu nutzen, unabhängig davon, welche Fähigkeiten Sie haben. Stereotypen, ich brauche das, um es komplett aus der Welt zu löschen.

Wir sind alle Menschen, wir haben nicht wirklich gewählt, wo wir geboren werden, wer unsere Eltern sind, wie unsere Erziehung, wie unsere finanzielle Situation ist, es war nicht unsere Wahl, warum müssen wir dafür bestraft werden? Wir haben die Verantwortung gegenüber der Welt, allen zu helfen. Wir sind soziale Menschen, wir gedeihen wirklich, wenn wir gute Verbindungen und gute Bindungen haben. Wir müssen wirklich die Dinge nutzen, die uns besser machen. Wir haben also so viele Talente, dass wir sie zum Wohle der Welt einsetzen können. Ich weiß, dass es in Ländern immer Kämpfe und eine Politik geben wird, dass jeder nach der Macht sucht, die nicht verschwinden wird. Aber wir, als Menschen, die Teil dieser Welt sind, müssen wirklich versuchen, alle um uns herum weiterzubilden und weiterzubilden. Ich hoffe wirklich, dass die Frauen in allen anderen Ländern wissen, dass sie es wert sind, dass sie so gut sind wie alle anderen. Sie haben die Macht, sie wissen nicht, wie viel Stärke und Macht sie haben. Es kommt also aus Selbstvertrauen. Glauben Sie an sich selbst und Sie werden überrascht sein, wie viel Sie erreichen können.

Nick Muldoon:

Da hast du's. Glaub an dich selbst und du wirst überrascht sein, wie viel du erreichen kannst. Maysa Safadi, vielen Dank für Ihre Zeit. Ich weiß es wirklich zu schätzen.

Maysa Safadi:

Vielen Dank Nick. Danke euch allen.

„Ich fand es toll, den Raum zu haben, um über gemeinsame Interessen zu sprechen — alles rund um technische Dokumentation und Informationsarchitektur“ — Henri Seymour

In dieser Folge von The Easy Agile Podcast hören Sie Henri Seymour, Entwickler bei Easy Agile, mit Matt Reiner, Customer Advocate bei K15t, sprechen.

Henri & Matt sprechen über alles, was mit technischer Dokumentation zu tun hat (wir versprechen, dass diese Episode viel interessanter ist, als sie sich anhört! 😉)

✏️ Technische Dokumentation als Produkt betrachten
✏️ Der Wert einer gut geschriebenen Dokumentation
✏️ Warum du oft digital entrümpeln solltest
✏️ Informationsarchitektur

So viele Goldnuggets in dieser Folge!

Abonniere unbedingt, genieße die Folge 🎧

Transkript

Henri Seymour:

Hallo zusammen. Das ist der Easy Agile Podcast. Wir haben heute eine Folge mit Matt Reiner. Ich bin dein Gastgeber für heute, Henri Seymour, Entwickler bei Easy Agile. Und kurz bevor wir mit dem Podcast beginnen, möchte ich den traditionellen Australiern des Landes, in dem ich heute aufnehme, meine Anerkennung aussprechen, dem Volk der Watiwati aus der Dharawal-Nation. Respektieren Sie die Ältesten in der Vergangenheit, Gegenwart und in der Zukunft, und erweisen Sie diesen Respekt allen Aborigines oder Bewohnern der Torres Strait Islander, die sich diese Episode anhören.

Matt ist ein erfahrener Content-Stratege mit langjähriger Erfahrung in der Computersoftwarebranche. Er kennt sich mit agilen Scrum-Frameworks, verwandten Tools, Kommunikation, technischem Schreiben, Videoproduktion, Kundeninteraktion und strategischer Planung aus. Und er ist heute hier, um mit uns über das Schreiben und insbesondere über technisches Schreiben und Dokumentation zu sprechen. Hallo, Matt.

Matt Reiner:

Hallo. Es ist toll, hier zu sein. Ja, ich bin Matt. Ich mag alle möglichen inhaltlichen Dinge. Und eines davon ist technisches Schreiben, was, wie ich finde, interessanter ist, als es klingt. Ich schätze, du musst dich bis zum Ende des Podcasts entscheiden, wenn du das glaubst.

Henri Seymour:

Experten für technische Dokumentation. Wenn Sie also speziell über technische Dokumentation sprechen, was meinen Sie damit?

Matt Reiner:

Nun, ich habe das Gefühl, dass sich dieser Begriff gerade mitten in einer großen Veränderung befindet. In der Vergangenheit hieß es in der technischen Dokumentation sehr strikt: „Okay, wir sind ein Team, wir machen etwas, ein Produkt.“ Vielleicht ist es eine App, vielleicht ist es, ich weiß nicht, ein Gokart und dafür brauchen wir eine Bedienungsanleitung. In der technischen Dokumentation hat sich jemand hingesetzt und aufgeschrieben: „Okay, hier sind alle Knöpfe und Schalter und hier ist, was sie tun. Hier sind alle Funktionen. Hier ist vielleicht der Grund, warum du sie verwenden würdest.“

Also die Zusammenstellung der Bedienungsanleitung, bei der es sich traditionell um gedrucktes Material handelte, das Sie mit dem Produkt erhalten würden. Aber im Laufe der Zeit ist es viel mehr geworden, teilweise mit dem Internet, weil wir einfach ständig an Inhalten arbeiten können, wie es viele von uns mit den Produkten tun, die unsere Teams herstellen. Und dann sehen wir es auch in neuen Formen. Vielleicht ist es kein gedrucktes Stück, tatsächlich wollen die meisten Leute keine gedruckte technische Dokumentation mehr, sie wollen sie online. Oder noch besser, sie wollen es direkt im Kontext Ihrer App haben, wenn sie sie verwenden. Sie können einfach die Informationen abrufen, die sie benötigen, und dann weitermachen.

Das ist technische Dokumentation. Sie sollte da sein, um dir zu helfen, das zu tun, was dir wirklich wichtig ist, und dann aus dem Weg zu gehen, damit du es tun kannst.

Henri Seymour:

Haben Sie eine Beschreibung, warum gute technische Dokumentation? Für Produktbenutzer ist es so wichtig, sie nicht nur zu haben, sondern sie in einer guten Qualität zu haben, sodass Ihre Benutzer wirklich davon profitieren.

Matt Reiner:

Nun, ich nehme an, wir alle finden in unserem Tag oder auf unserer Reise die Punkte, an denen wir uns befinden, an denen wir etwas erreichen wollen, aber wir wissen nicht, wie wir es machen sollen. Viele von uns haben sich also wirklich sehr daran gewöhnt, auf Google zu springen und zu sagen: „Okay, hier ist diese Sache, die ich machen möchte, wie mache ich das?“ Und es gibt eine gute technische Dokumentation mit der Antwort, die Sie benötigen, der Erklärung, die Sie benötigen. Denn letztlich sind wir alle kluge Menschen, die befähigt werden sollten, das zu tun, wofür wir eine Leidenschaft haben.

Und technische Redakteure und Kommunikatoren, die eigentlich alle Mitglieder unseres Teams sind. Leute, die sich hinsetzen, um eine gute technische Dokumentation zu erstellen, verwenden so wenig Worte wie möglich, um eine Person auf den richtigen Weg zu bringen. Und wenn es passiert, ist es einfach wie „herrlich“, nicht für den Benutzer. Sie wissen nicht einmal, dass es passiert ist, sie wussten nicht einmal, dass sie deine Texte gelesen haben. Aber für den Autor ist es wie: „Ja, ich habe es geschafft, ich habe es getan. Es ist ihnen egal, was ich getan habe, aber ich habe es getan.“ Und jetzt tun sie das, was wirklich wichtig ist.

Henri Seymour:

Das ist großartig, einen der Hauptunterschiede zu verstehen, wenn ich etwas geschrieben habe und nicht möchte, dass mein Benutzer Zeit damit verbringt. Ich möchte so wenig Zeit wie möglich damit verbringen, dies zu lesen.

Matt Reiner:

Ja, ja, ja. Sie können sehr stolz auf Ihre Arbeit sein, aber eine dieser Kennzahlen, die sich viele Leute bei Websites ansehen, ist die Zeit, die Sie auf einer Seite verbringen. Manchmal können Sie sich also etwas vormachen und denken: „Oh wow, sie haben 10 Minuten auf meiner Seite verbracht. Das heißt, meine Dokumentation ist wirklich gut.“ Aber das könnte auch bedeuten, dass es nicht sehr gut ist und sie es immer wieder lesen müssen. Die wahre Metrik ist also, sind sie zu dem gekommen, was ihnen wirklich wichtig war? Und leider ist es schwer zu messen.

Henri Seymour:

Sie haben das jetzt mit dem Aufkommen des Internets erwähnt und Ihnen die Möglichkeit gegeben, diese Dokumente auf eine Weise zu wiederholen, die Sie mit gedruckter Dokumentation nicht könnten. Diese iterative Sache bringt den agilen Prozess mit sich, etwas, das Sie bereits veröffentlicht haben, zu wiederholen und es auf die gleiche Weise zu verbessern, wie ich es als Entwickler für Produkte tue. Kannst du uns mehr über diesen iterativen agilen Prozess erzählen?

Matt Reiner:

Oh ja. Ja, es ist so wahr. Früher war die Dokumentation wieder im Wasserfall-Standard, eher in der Zeit des Produktprojektmanagements, die Dokumentation war ein wichtiger Teil davon. Sie würden dieses Projekt damit beginnen, diese riesigen Dokumente zu schreiben, in denen es heißt: „Folgendes werden wir tun. Und hier sind alle Überlegungen, und hier erfahren Sie, wie alles zusammenhängt.“ Und das hat für eine Menge Hardware wirklich gut funktioniert. Das war das Ding, das wir lange gemacht haben. Einfach alles, was die Menschheit gemacht hat, war oft Hardware, zumindest als Gruppe.

Und dann kommt plötzlich diese ganze Software-Sache und wir versuchen, sie so zu bauen, als wäre es eine physische Sache. Und wir kommen zum Ende dieses zweijährigen Softwareprojekts und die Leute sagen: „Ja, das ist nicht das, was ich wollte.“ Aber wir sagen: „Oh, aber wir gehen zurück zum Anfang und schauen uns die Dokumentation an, und das haben Sie gesagt, Sie wollten es.“ Aber jetzt, mit dem Internet und nur mit agiler Entwicklung, müssen wir wirklich weg von diesem Ort, an dem wir mit einem Stapel von Dokumenten beginnen. Und dann entwickeln wir einen weiteren Stapel von Dokumenten als unsere, ich weiß nicht, Entwicklungsrichtlinien.

Und dann unsere Testpläne, und dann endlich haben wir die Benutzerdokumentation. Stattdessen sollte die Dokumentation heutzutage eigentlich nur von einem sehr kleinen Teil des Inhalts während des gesamten agilen Entwicklungszyklus zur endgültigen Benutzerdokumentation heranwachsen. Denn es spielt keine Rolle, was wir uns vorgenommen haben, es kommt darauf an, was wir machen. Niemand, er will darüber lesen, was wir zu tun dachten, das ist reine Fiktion. Und es ist wahrscheinlich keine interessante Lektüre. Es ist wirklich das endgültige Benutzerhandbuch, das aus dem agilen Prozess hervorgeht, aber das ist eine große Änderung, aber sie ist gut.

Henri Seymour:

Ich liebe diese Vorstellung von einfach so, das wächst allmählich. Es gibt keinen bestimmten Startblock und Endblock. Es ist ein Prozess. Und Sie haben die Möglichkeit erwähnt, diese Dokumente zu wiederholen. Haben Sie irgendwelche Tipps für die Zeit, nachdem Sie Ihre technische Dokumentation digital veröffentlicht haben, indem Sie das, was Sie bereits haben, wiederholen und im Laufe der Zeit verbessern?

Matt Reiner:

Oh ja. Ich weiß, dass jedes agile Framework anders ist, aber sie alle haben diese Feedback-Phase, in der... Und das ist wirklich während des gesamten Prozesses so, aber wir müssen etwas Zeit investieren. Es gibt also viele verschiedene Dinge, die wir uns ansehen können. Ich möchte zum Beispiel nicht einfach sagen, ein Standardprogramm, das wir uns ansehen sollten, ist, Sie sollten ein Hilfecenter haben, in dem Sie etwas wie Google Analytics implementieren können, damit Sie sehen können, was sich die Leute ansehen? Wie lange schauen sie sich das an?

Eine weitere wirklich gute ist, dass Sie es separat in Google Analytics einrichten müssen. Wonach suchen die Leute auf Ihrer Website? Du kannst auch Google verwenden... das waren früher Webmaster-Tools. Ich glaube, es heißt jetzt Site Tools, aber du kannst sehen, wonach die Leute bei Google gesucht haben, bevor sie auf deine Seiten kamen. Das ist alles wirklich, wirklich wertvolles Zeug. Dann kannst du weiter fortgeschritten sein. Du kannst dir Pointer-Tracking ansehen, Apps, die du dort einbetten kannst und bei denen du ziemlich verrückte Sachen bekommst.

Aber dann solltest du auch erwägen, am Ende jeder Seite ein Forum zu haben wie: „War das hilfreich? War es nicht hilfreich? Oh, es war nicht hilfreich? Sag mir warum. Oh, es war hilfreich? Sag mir warum.“ Genau wie ein YouTube-Ersteller suchen sie nach diesem Feedback. Dieses Feedback ist wichtig, Daumen hoch. Tatsächlich ist es sehr umstritten, YouTube hat gerade angekündigt, die Zahlen mit dem Daumen nach unten zu verbergen, aber viele YouTuber sagen: „Nein, nein, nein, tu das nicht, denn das vermittelt den Wert dieses Videos, das da draußen ist.“

Es gibt also viele dieser Signale. Und dann gibt es einfach wirklich sanfte Signale, bei denen es schwer ist zu wissen, ob die Leute den Inhalt nutzen oder nicht. Weil du es vielleicht nie hören wirst. Vor allem, wenn es eines dieser Dinge ist, dass sie einfach rein und raus gehen, wirst du nichts davon hören. Aber die Feedback-Phase, es ist wirklich toll,... Jedes Mal, wenn Sie Feedback zu Ihrem Produkt erhalten, das Sie herstellen, versuchen Sie, auch Ihre Dokumentation zu veröffentlichen. Denn das ist die Zeit, in der die Leute offen dafür sind, Ihr Produkt zu erkunden und Feedback zu geben.

Warum also nicht dieselbe Dokumentation untersuchen, die dazugehörige Dokumentation, um zu sehen: „Okay, hilft das diesen Leuten tatsächlich dabei, das zu tun, was sie tun wollen? Oder sollten wir es genauso verbessern, wie wir es mit dem Produkt tun?“

Henri Seymour:

Nein, das ist wirklich gut, wenn man das vergleicht, wir haben gerade ein Produkt veröffentlicht. Geben Sie uns Feedback, wenn Sie dasselbe mit der Dokumentation tun. Denn dann wird es seinen Höhepunkt erreichen, bevor jeder den Dreh raus hat. Wir haben gerade diese Feature-Version veröffentlicht, teilen Sie uns mit, wie Sie sie verwenden, und die Dokumentation ist gewissermaßen Teil davon, insbesondere für komplexere Produkte.

Matt Reiner:

Exakt.

Henri Seymour:

Haben Sie irgendeinen Hintergrund in der Kundenbetreuung? Wir führen den Kundensupport sowie deren Dokumentation intern durch. Deshalb versuchen wir, die Dokumentation zu verbessern, um die Supportbelastung unseres Teams zu verringern. Hast du irgendeinen Hintergrund in dem... Kannst du es lösen?

Matt Reiner:

Ja. Ja und nein. Es ist interessant. Ich arbeite jetzt bei K15t, ich war früher Kunde von K15t, also habe ich das Team so kennengelernt. Und so habe ich auch die Dokumentation überhaupt erst kennengelernt. Bei meinem letzten Job haben sie mich beauftragt, dieses System namens Jira zu verwalten. Und ich sagte: „Ich weiß nicht, was das ist.“ Ich sagte ihnen: „Ich dachte, ich könnte es schaffen.“ Und ich habe es herausgefunden, es war dieses kleine Ding namens Jira On-Demand, das jetzt Jira Cloud ist. Und ich habe dem Unternehmen auch Confluence On-Demand vorgestellt. Und wow, ich habe Jira oft kaputt gemacht.

Zum Glück war es zu der Zeit nicht unternehmenskritisch, wir waren immer noch dabei, es wirklich herauszufinden. Aber erst durch die Dokumentation von Atlassian zu Jira habe ich wirklich gelernt: „Wow, diese Inhalte haben hier einen enormen Wert.“ Und dann entdeckte ich: „Okay, wie erstellt Atlassian ihre Dokumentation? Oh, sie machen das in Confluence. Sie schreiben es in Confluence. Sie verwenden diese Apps von K15t.“ Also fing ich an, diese Apps zu verwenden, und dann habe ich viel mit dem K15t-Kundensupport gesprochen, nur Fragen und wie fange ich damit an?

Und wir bieten unseren Support auch intern an, also ist es wirklich großartig. Also vielleicht habe ich es als Kunde zu oft genutzt, ich weiß nicht. Ich sollte einige meiner Kollegen fragen, ob sie genug von mir haben. Aber der Vorteil lag auf der Hand, denn sie sagten mir: „Oh, hier ist die Dokumentation dazu. Und hier ist die Antwort auf diese Frage oder hier sind die Überlegungen, die Sie berücksichtigen sollten.“ Und tatsächlich schauen wir uns jetzt einige unserer Teams wirklich an, vor allem nach den Funktionen, die sehr robust sind, und die Leute haben Fragen.

Es ist also wie, wie können wir ihnen helfen, sich selbst zu helfen? Und diese Ressourcen bereitzustellen ist eine Sache, sicherzustellen, dass Google sie finden kann, nun ja, eine andere. Aber das ist eine wirklich wichtige Sache, vor allem, weil als Produktteam, wenn Ihre Nutzerbasis wächst, auch Ihr Bedarf an Unterstützung steigt. Es ist nur... Ich will nicht sagen, dass es exponentiell ist, aber es entspricht einander. Eine der Möglichkeiten, dem entgegenzuwirken, besteht darin, sicherzustellen, dass Sie ein gutes Design haben, damit Ihr Produkt einfach zu bedienen ist. Und zum anderen benötigen Sie gute Inhalte rund um das gesamte Erlebnis, damit Sie nicht immer mehr Support-Mitarbeiter einstellen müssen.

Oder Ihre Support-Mitarbeiter können sich spezialisieren und sich wirklich auf diese tief verwurzelten Probleme konzentrieren, und dann sollte die Dokumentation beim Rest helfen. Aber das Geheimrezept ist knifflig. Es ist schwierig, den perfekten Inhalt zu schreiben, um die Fälle abzuwehren. Das ist jedermanns Traum.

Henri Seymour:

Auch wenn es einfach nicht alle sind, aber einige der häufigsten Anwendungsfälle werden langsam vom Support abgelenkt, weil die Leute Self-Service machen können. Das macht einen Unterschied. Und ich verstehe auch die Idee der Jira-Dokumentation wirklich. Easy Agile funktioniert auf Jira und es ist... Jira ist derzeit ein unglaublich kompliziertes Produkt, und ich kann mir vorstellen, dass es wahrscheinlich auch kompliziert war, als es Jira On-Demand war. Weil es so kompliziert und detailliert ist, gibt es keine Möglichkeit, es einem Benutzer ohne diese Dokumentation leicht verständlich zu machen. Daran führt kein Weg vorbei.

Matt Reiner:

Ja. Ich denke, es sollte einen Club für die Leute geben, die in Jira zu oft Workflows kaputt gemacht haben. Aber ja, ich meine, die Dokumentation hat mich viele Male gerettet und ich müsste eine... Nun, zu der Zeit war es eine HipChat-Nachricht. Möge es in Frieden ruhen und ich müsste sagen: „Ich habe Jira kaputt gemacht, gib mir eine Minute. Ich muss etwas lesen gehen.“ Nicht so, wie du Jira lernen möchtest, aber es ist eine Option.

Henri Seymour:

Ist es. Manchmal lernt man Dinge, indem man Dinge kaputt macht. Das ist...

Matt Reiner:

Das ist richtig.

Henri Seymour:

Scheint wirklich meine bisherige Erfahrung mit Software zu sein. Du versuchst, die Dinge kaputt zu machen, die die Leute gerade nicht benutzen, und das ist ungefähr alles, was du tun kannst.

Matt Reiner:

Exakt.

Henri Seymour:

Also hat K15t kürzlich Rock the Docs veröffentlicht. Kannst du uns etwas mehr über dieses Projekt erzählen?

Matt Reiner:

Ja. Rock the Docs, eigentlich ging das aus einer Menge Informationen hervor, die ich von K15t bekommen habe. Kundensupport, die ich von der K15t-Dokumentation erhalten habe, habe ich von der Atlassian-Dokumentation erhalten. Und dann einige Dinge, die ich selbst herausgefunden habe, oder einige meiner Kollegen bei K15t haben es getan. Im Grunde genommen, was sind die besten Methoden, um wirklich gute Inhalte in Confluence zu erstellen? Und es begann wirklich mit einer Sammlung von Anleitungen zur Erstellung von Inhalten zur technischen Dokumentation. Es ist darauf ausgerichtet, ein öffentliches Hilfecenter einzurichten, aber in Wirklichkeit ist es für alle Arten von Inhalten, die Sie möchten, wie immergrüne, langjährige Inhalte, um Menschen helfen zu können.

Wir haben also zunächst über alle möglichen Dinge gesprochen, wie die Strukturierung deiner Inhalte, die Wiederverwendung von Inhalten und die Verwaltung mehrerer Sprachen, was in Confluence schwierig sein kann. Zusammenarbeit, Veröffentlichung deiner Inhalte auf die eine oder andere Weise außerhalb von Confluence, Verwaltung von Versionen dieser Inhalte. Das ist also der Anfang. Und dann bekamen wir eine Menge positiver Reaktionen und hatten allgemeinere Fragen wie: „Okay, aber was sind die besten Möglichkeiten, Feedback in Confluence zu erhalten?“ Oder: „Wie erstelle ich eine Vorlage oder eine gute Vorlage oder wie erstelle ich ein gutes Diagramm in Confluence?“

Deshalb haben wir diesen Inhalt erweitert, sodass er sich auf alle möglichen allgemeinen Confluence-Dinge konzentriert. Weil wir festgestellt haben, dass es da draußen eine Menge Informationen darüber gibt, wie man etwas macht. Die Atlassian-Dokumentation war wirklich hilfreich, aber es gab nicht so viele. Ich frage mich: „Warum würdest du das tun? Und warum würdest du das auf diese spezielle Art machen?“ Und wir arbeiten jetzt seit über 10 Jahren mit Confluence zusammen. Wie ich schon sagte, ich bin seit den ersten Tagen mit den krassen Wolken bei Confluence. Es ist so schnell gewachsen, es ist wunderschön.

Aber wir wissen einfach, dass wir eine Menge Dinge mit Confluence gemacht haben, also war es ein echtes Privileg, das beide in Form dieser schriftlichen Anleitungen zu teilen. Und dann haben wir vor Kurzem auch damit begonnen, eine Serie auf unserem YouTube-Kanal zu veröffentlichen, in der es um die Best Practices von Confluence geht.

Henri Seymour:

Das ist großartig. Es ist wirklich interessant zu hören, dass das als kleineres Projekt begann, als es sich herausstellte, weil man den Wert und den Nutzen darin sehen konnte. Wir haben jetzt ein paar Mal über Confluence gesprochen und K15t entwickelt Apps, die Confluence als Dokumentationsquelle verwenden. Kannst du uns mehr darüber erzählen, warum Confluence für die Erstellung technischer Dokumentationen nützlich ist? Welche Tools und Herangehensweisen machen es in diesem Zusammenhang nützlich?

Matt Reiner:

Ja. Confluence ist von Natur aus offen, und so werden technische Schreibwerkzeuge nicht gebaut. Tatsächlich erinnere ich mich an das erste Mal, als ich zu einer Konferenz für technisches Schreiben ging und mich jemand fragte: „Oh, welches Tool verwendest du?“ Das ist quasi das, worüber die Leute in der technischen Kommunikation sprechen, weil wir in dieser Hinsicht alle Nerds sind. Und ich dachte: „Oh, ich mache das in Confluence.“ Und danach wollten sie nicht wirklich mit mir sprechen, weil sie nicht dachten, dass ich ein ernsthafter Tech-Autor bin. Und ich sagte: „Oh nein, nein, nein, nein, das passiert alles.“

Zu diesem Zeitpunkt existierte Rock the Docs noch nicht. Also konnte ich nicht sagen: „Geh rüber und sieh, wie es funktioniert.“ Aber der größte Unterschied ist, dass die meisten technischen Schreibwerkzeuge einfach komplett gesperrt sind. Sie haben zwei Lizenzen für Ihre beiden Personen, die ausgebildete professionelle technische Korrektoren sind, und dann für alle anderen, es gibt keinen Zugriff. Du berührst es nicht. Vielleicht schicken Ihnen Ihre technischen Redakteure ein PDF und Sie müssen den gottschrecklichen Prozess durchlaufen, ein PDF zu markieren, um ihnen mitzuteilen, was sie korrigieren müssen. Oder ich habe von Teams gehört, die den Inhalt ausdrucken und Leute angeben, was geändert werden muss.

Die Überprüfungsverfahren sind einfach nicht von dieser Welt verrückt. Und diese Tools passen nicht besonders gut zu agilen Prozessen, weil es so ist, du baust das Ding hier drüben und dann sind hier die beiden technischen Autoren in ihrem separaten Tool. Und irgendwann werden wir sagen: „Okay, das Ding ist fertig. Würdest du darüber schreiben?“ Bei Confluence besteht der Vorteil der Verwendung von Confluence also darin, dass es für jeden im Team und sogar für Personen außerhalb des Teams zugänglich ist. Und das ist unglaublich von einem Beamten, weil wir bei Agile gesehen haben, aber wir sehen auch in diesem Bereich der technischen Kommunikation und des Informationsdesigns, dass Teams immer weniger nach Fachkräften suchen, die ausgebildete technische Redakteure sind.

Was ein Oxymoron ist, weil die Hälfte von uns, wir haben keinen Abschluss in technischem Schreiben, wir sind aus dem einen oder anderen Grund darauf reingefallen. Aber jetzt beginnen die Teams zu erkennen: „Hey, ich kann Codeentwickler und Informationsentwickler werden. Ich schreibe vielleicht nicht den letzten schriftlichen Inhalt, der von unseren Kunden gesehen wird, aber vielleicht schreibe ich den ersten Entwurf.“ Confluence macht das wirklich allen zugänglich. Und gerade bei Erwähnungen und Inline-Kommentaren sind die Überprüfungsprozesse einfach so schnell.

Eigentlich war der Grund, warum ich bei meinem letzten Job zu Confluence gewechselt bin, dass mein Produktmanager mir drohte und sagte: „Ich werde kein weiteres PDF mit Markups versehen. Geh und finde ein gutes Tool, mit dem wir alle arbeiten wollen.“ Und dort sind wir auf Confluence gelandet. Es geht darum, das gesamte Team in den Schreibprozess einzubeziehen, anstatt dass es sich um eine separate Sache handelt. Denn wenn es eine separate Sache ist, verlieren wir den Überblick. Und beim Inhalt vergessen wir, wie wichtig er für unser Produkt ist, für den Kundenlebenszyklus, für... Gott segne den Kundensupport, der diese Inhalte wirklich, wirklich braucht, um gut und korrekt zu sein.

Und es muss von den echten Experten gesehen werden, die bestätigen: „Ja, okay, das ist richtig. Das wird den Leuten tatsächlich zeigen, wie unser Produkt funktioniert.“ Und Confluence ist quasi das Herzstück davon.

Henri Seymour:

Nein, es ist toll zu hören, wie das alles zusammenkommt, um die Dokumentation als Team zu erstellen. Können Sie näher auf die verschiedenen Rollen eingehen, insbesondere in der Softwareentwicklung, und auf die verschiedenen Rollen, in denen Sie sich an Ihrem Dokumentationsprozess beteiligen möchten? Wir arbeiten hier bei Easy Agile daran, unsere spezifischen App-Teams aufzubauen, da wir derzeit wachsen.

Matt Reiner:

Ja. Das ist so eine gute Frage. Nun, was...

Henri Seymour:

Und wie integriert man... Entschuldigung, das bezieht sich eher auf meine Frage. Wie integrieren Sie diesen technischen Schreibprozess in die Arbeit eines agilen Softwareentwicklungsteams?

Matt Reiner:

Nun, zunächst müssen die Prioritäten überdacht werden, weil die meisten Teams sagen: „Dokumentation hier unten, Testen und dann alles andere oben“. Im Allgemeinen sollten diese beiden Dinge also nach oben verschoben werden. Und eigentlich ist der Inhalt rund um unser Produkt... Ich möchte nicht traumatisch klingen, aber wenn wir keine Informationen haben, haben wir kein Produkt. Mir ist egal, wie viel Code du schreibst. Wenn wir es den Leuten nicht erklären, wenn wir keinen guten UI-Text haben, wenn wir keine gute In-App-Hilfe haben, existiert er nicht. Es ist kein nützliches Tool, es ist nur eine Reihe von mathematischen Methoden, mit denen Menschen nicht interagieren können.

Inhalte sind also unerlässlich, daher ist es wirklich wichtig, dass wir sie so weit bringen, dass jeder im Team erkennt, dass das Inhaltserlebnis, das unsere Nutzer haben, das Produkterlebnis ist, das sie haben. Es muss also Teil des Produktentwicklungsprozesses sein. Also dann der nächste Schritt, von dem ich weiß, dass Sie über Teamstruktur sprechen, aber der nächste Schritt ist, dass wirklich jeder im Team wissen muss, dass er ein Autor ist, und zwar ein guter Autor. Und das ist wichtig, weil viele Leute das noch nie gehört haben. Sie haben nie gehört, dass sie ein guter Schriftsteller sind, und sie haben wahrscheinlich nie gehört, dass sie Schriftsteller sind.

Ich erinnere mich an die Universität, mein Schreibunterricht waren die Dinge, auf die ich nicht geachtet habe. Ich habe Mathematik und Java-Programmierung und Statistik gemacht. Sogar das schien mir wichtiger zu sein, nicht der Schreibunterricht. Und dann stellt sich heraus, dass tatsächlich jeder schreiben muss. Wir schreiben alle. Es ist also wirklich wichtig zu wissen, dass das eine Rolle ist, die jeder ausfüllt. Und wenn es dann um die eigentliche Teamstruktur geht, braucht man Leute, die sozusagen bereit sind, die Streams zu überqueren. Wenn Sie jemanden hinzuziehen, der sich auf Testtechnik konzentriert, muss dieser erkennen, dass die Testpläne, die er schreibt, einer Menge Benutzerdokumentationen, die geschrieben werden müssen, sehr ähnlich sind.

Sie schreiben Aufgabenthemen oder Aufgabenanweisungen, tun Sie dies, tun Sie dies, tun Sie das immer und immer wieder. Das ist Dokumentation. Sie könnten auf diese Weise beitragen. Ingenieure könnten, wie ich bereits erwähnt habe, die erste Kopie vieler sogenannter Konzeptthemen verfassen. Also Bereiche der Dokumentation, in denen Sie Konzepte erklären, weil sie bereits wissen, was diese Konzepte sind. Wenn Sie sich in der Tat die Wurzeln vieler agiler Entwicklungsteams ansehen, verwenden sie Epen, User Stories und Akzeptanzkriterien. Und all diese lassen sich perfekt in die Dokumentation integrieren, die Sie für das neue Feature, an dem Sie arbeiten, oder das Sie verbessern, erstellen mussten.

Es ist also wirklich wichtig, dass jeder erkennt, dass wir alle bereits Dokumentationen erstellen, damit wir einen Beitrag leisten können. Und dann möchten Sie natürlich wirklich mindestens einen englischen Muttersprachler haben. Vielleicht kein Muttersprachler, aber jemand, der sich in seinem Englisch oder in der Sprache, in der Sie schreiben, sicher fühlt. Englisch lässt sich in der Regel am billigsten in andere Sprachen übersetzen, also ist es das, wofür sich die Leute oft entscheiden. Aber diese Person ist die Person, die alles, was jeder geschrieben hat, nimmt und es auf den richtigen Stil und Ton bringt. Und dann bringt er es raus. Das ist es, was wir als erfolgreich ansehen.

Wie unsere Teams im Moment haben wir keine seriösen Tech-Autoren. Wir haben Produktmanager, die schreiben. Wir haben Produktvermarkter, die schreiben. Wir haben Ingenieure, die schreiben. Einige der besten Dokumentationen, die ich je gelesen habe, stammen von einem unserer deutschsprachigen Ingenieure. Ich dachte: „Peter, das ist eine tolle Anleitung. Du musst dieses Java verlassen und Englisch lernen, Mann. Es ist großartig. Es ist großartig.“ Also hat er ein paar gemacht, was ich wirklich liebe. Aber ja, es geht darum, aus den typischen Rollen herauszuspringen und zu erkennen, dass wir das alles sowieso alle dokumentieren.

Henri Seymour:

Ich liebe den Fokus, besonders mit Ihrem deutschsprachigen Kollegen. Der Fokus liegt nicht nur darauf, dass Sie die Dokumentation schreiben müssen, weil Sie wissen, wie das Produkt funktioniert, und das brauchen wir schriftlich. Es ist, Sie sind in der Lage, die Dokumentation zu schreiben, Sie können das tun. Sie haben diese zusätzliche Sicherheitsbarriere gegenüber jemandem, der die Sprachkenntnisse hat, dass er es am Ende massieren und bearbeiten wird.

Also, bevor es irgendwohin kommt, wird alles, was Sie tun, herausgefiltert, wenn es nicht funktioniert. Sie benötigen jedoch keinen speziellen technischen Hintergrund, um die Dokumente zu schreiben.

Matt Reiner:

Nein, absolut nicht. Tatsächlich gibt es eine ganze Gemeinschaft von was... Sie nennen sich selbst Dokumentarfilmer und heißen Write the Docs. Und diese ganze Community, diese ganze Gruppe konzentriert sich darauf, es spielt keine Rolle, was Sie tun, es ist wichtig, dass es Ihnen wichtig ist, die Dokumente zu schreiben und zum Inhalt beizutragen. Und das war, glaube ich, ein großer Wandel in der Branche, wo die Leute dachten, wir wären getrennt. Aber jetzt ist es so: „Nein, nein, nein, wir sind alle in der Lage, das zu tun.“ Und sobald wir die Beiträge respektieren können, die jeder von uns leisten kann.

Und dann habe ich auch den Schutz, dass jemand anderes seine Augen darauf richten wird, was selbst in meinem Schreiben, ich sage: „Ich schicke es nicht gerne raus, bis es jemand anderes gesehen hat.“ Weil ich ständig Rechtschreib- und Tippfehler mache. Ich möchte wirklich, dass sich ein anderer Kollege das ansieht. Auch wenn sie kein Englisch als Muttersprache haben, weil sie meine Tippfehler ziemlich oft erwischen. Dieses Gefühl der Zusammengehörigkeit ist genauso, wie wir uns fühlen, wenn wir ein Projekt oder ein Produkt versenden.

Egal, ob Sie die Tests dafür durchgeführt haben, oder ob Sie den Code dafür geschrieben haben oder ob Sie das Produktmarketing dafür gemacht haben. Es ist wie: „Es ist unser Baby. Lass es uns rausschicken und sehen, was passiert.“ Der Inhalt ist genauso.

Henri Seymour:

Ja, Teil meiner täglichen Rolle und [unhörbar 00:28:03]... Wir haben kein QA-Team, das von den Entwicklern getrennt ist. Unsere Entwickler überprüfen auch unseren Code und es entsteht das Gefühl: „Ich habe dieses Ding geschrieben, aber ich habe ein oder zwei andere Leute, die es verfeinert haben und dafür gesorgt haben, dass die Qualität gut genug ist. Sie haben diesen frischen Blick, also werden sie die Rechtschreibfehler sehen, sie werden die kleinen kleinen Fehler erkennen, die ich mir einfach zu lange angesehen habe, um sie noch zu bemerken.“

Ich habe festgestellt, dass der Prozess des Schreibens von Dokumentationen einige Parallelen hat, wie zum Beispiel: „Hier ist mein Ding. Ich hätte gerne Feedback dazu, bevor es in die reale Welt geht.“

Matt Reiner:

Ja.

Henri Seymour:

Das ist großartig.

Matt Reiner:

Ja, absolut. Ja.

Henri Seymour:

In Ordnung. Können Sie etwas über den Unterschied zwischen der kundenorientierten Dokumentation, die wir bisher hauptsächlich besprochen haben, und der internen Dokumentation sprechen?

Matt Reiner:

Ja. Es gibt einige Unterschiede und es gibt einige große Ähnlichkeiten. Also das ist sehr... Das klingt sehr technisch und hässlich. Der Begriff Informationsarchitektur ist wirklich wichtig für jede Art von Inhalten, intern und extern. Und das ist wirklich so, wenn Sie ein Entwickler sind, kennen Sie sich mit XML aus, Sie sind damit vertraut, Dinge auf diese Weise zu strukturieren. Unsere Inhalte müssen auf die gleiche Weise funktionieren. Und das gilt für die interne und externe Dokumentation. Also, viele der Dinge, die sie als Autoren verwenden, wenn sie eine Seite oder einen Artikel in der Zeitung schreiben, verwenden sie den Pyramidenansatz, bei dem sie die großen Informationen an die Spitze stellen. Und dann konzentrieren sie sich langsam auf das Thema und geben immer mehr Informationen darüber.

Sie sollten jedoch sicherstellen, dass jemand, der nur den ersten Absatz liest, eine ungefähre Vorstellung davon bekommt, um welche Informationen es sich handelt. Und das ist wirklich wichtig für erfolgreiche Confluence-Seiten und -Bereiche. Die Leute sollten in der Lage sein, auf der obersten Ebene des Bereichs zu beginnen, zu verstehen, worum es in dem Bereich geht, und dann in der Lage sein, auf der Seite selbst zu dem zu navigieren, worüber sie wirklich lernen möchten. Was dann aus Überschriften, Unterüberschriften und Aufzählungspunkten bestehen sollte, um diese Informationen einfach zu verbreiten und aufzuschlüsseln. Weil jeder überfliegt.

Wir brauchen, dass unsere Inhalte überflogen werden können, unsere Räume müssen überflogen werden können. Und diese Art von Inhalten macht auch die Confluence-Suche glücklich, insbesondere die neue Confluence Cloud-Suche, die stark verbessert wurde. Dazu gibt es eine ganz neue elastische Suchbasis, die gerade optimiert wird. Aber es ist glücklich, es ist genau wie bei Google, wenn wir unsere Inhalte so strukturieren. Wenn Sie also eine Seite haben, die nur aus Text besteht, ohne Überschriften, die Sie nicht in Seiten oder gar Leerzeichen aufteilen, wird niemand damit zufrieden sein.

Die Bots werden damit nicht zufrieden sein, die Leute, die lesen, werden damit nicht zufrieden sein. Es erfordert also ein bisschen Arbeit, die Struktur unserer Inhalte zu strukturieren und aufzubrechen. Es ist wahrscheinlich alles in Ordnung, solange es aktuell ist, aber es ist wirklich wichtig, dass wir darüber nachdenken, wie wir das in Confluence strukturieren, damit die Leute es finden und die Leute es überfliegen können. Und genau das scheint viele interne Confluence-Instanzen zu plagen, denn viele... Vielleicht konzentriert sich das Team nicht so sehr darauf.

Es ist wie: „Oh, unser externes Hilfecenter, das aus diesem Bereich hier kommt, das ist in Ordnung. Unser Teamraum, großes Durcheinander, totaler Reifenbrand.“ Und niemand kümmert sich darum, weil sie glauben zu wissen, wo alles ist. Aber dann fängst du an, darüber nachzudenken: „Okay, aber was ist mit dem neuen Teammitglied? Wie finden sie etwas?“ Oder: „Was ist mit dem Teammitglied, das seit sechs Wochen wegen Vaterschaftsurlaubs weg ist? Werden sie sich daran erinnern, wo alles ist, oder wissen sie, wo all die neuen Sachen sind?

Was ist mit Menschen mit Behinderungen? Wird es für sie viel schwieriger sein, zu den Informationen zu navigieren, die sie benötigen? Weil sie mit einem Screenreader arbeiten und versuchen, durch eine Textwand zu gehen. Sie benötigen Überschriften, ein Screenreader verlässt sich auf diese Überschriften und Titel.“ Es gibt also einfach so viele Überlegungen, die die Unternehmensführung wirklich verstehen muss. Nur weil Sie einen Prozess haben, um etwas zu tun, oder die Informationen irgendwo sind, heißt das nicht, dass Sie kein großes Informationsproblem haben. Und all deine Inhalte in Confluence zu pflegen und dann gut zu pflegen.

Dies ermöglicht es den Menschen, die Frustration zu vermeiden, nach Informationen zu suchen, Informationen zu verlieren, Informationen neu lernen oder neu schreiben zu müssen. Ich habe in zu vielen Unternehmen gearbeitet, in denen Informationen einfach überall gesiebt werden. Ich möchte sie nicht einmal Silos nennen, weil auch niemand mehr weiß, wo sich die Dinge befinden. Das ist es, was Confluence ausmacht, und darauf kommt es sowohl bei internen als auch bei externen Inhalten an.

Henri Seymour:

Das ist eine großartige Perspektive. Und ich kann die Silos sehen, es ist wirklich mehr... Nur ein großer Stapel, du kannst nichts finden. Ich war...

Matt Reiner:

Exakt.

Henri Seymour:

... seit mehr als der Hälfte seines Lebens bei Easy Agile und ich habe das Gefühl: „Oh, ich weiß, ich habe das irgendwo aufgeschrieben. Ich weiß, dass ich das irgendwo aufgeschrieben gesehen habe.“ Und wir machen es uns zur Gewohnheit, vor allem, weil wir immer mehr Leute einstellen. Jedes Mal, wenn jemand ein Onboarding durchläuft, wird er sich die gesamte Dokumentation ohne vorherige Hintergrundinformationen ansehen. Und wir möchten speziell ihr Feedback dazu hören. Denn wenn es für sie funktioniert, dann ist das die Dokumentation, die wir für sie und für alle nach ihnen brauchen, und für alle, die schon hier sind.

Vor allem bin ich jetzt seit fast drei Jahren bei Easy Agile und ich habe gesehen, wie es von acht Mitarbeitern auf jetzt, glaube ich, über 20 Jahre gewachsen ist. Ende des Jahres werden wir in die 30er Jahre übergehen.

Matt Reiner:

Beeindruckend.

Henri Seymour:

Das Wachstum der Informationen, die wir in unserer internen Dokumentation haben, und ich bin mir sicher, dass dies mit dem Wachstum der Produktdokumentation für ein Produkt einhergehen würde, das seit drei bis fünf Jahren expandiert. Wie verwaltest du die Dokumentation und die Confluence-Bereiche, wenn das Team und das Unternehmen wachsen und du einfach immer mehr Seiten daraus entwickelst?

Matt Reiner:

Das ist die Frage seit den Anfängen des Universums oder zumindest seit den Anfängen von Confluence, was ist der Unterschied? Die größte Sache ist die Teamverantwortung, also zu wissen, dass dies unser Raum ist, das ist unser Inhalt. Und zwar nicht auf territoriale Weise, aber das liegt in unserer Verantwortung. So wie wir über unseren Planeten nachdenken sollten, sollten wir auch über unsere Inhalte nachdenken und dafür sorgen, dass sie gepflegt und gepflegt, aktuell und korrekt sind. Und dann, wenn sich die Dinge ändern.

Wir haben zum Beispiel ein Produkt namens Scroll Viewport, mit dem du Inhalte von Confluence in einem öffentlichen Gesundheitszentrum veröffentlichen kannst, was wirklich, wirklich cool ist. Damit hatten wir also eine Server- und Rechenzentrumsversion. Das haben wir schon seit geraumer Zeit. Das war es, was ich genutzt habe. Und dann haben wir uns auf den Weg gemacht, eine Cloud-Version zu entwickeln, und die Cloud erfordert eine ganze Reihe neuer Infrastrukturen, was viel Spaß macht und sehr herausfordernd ist, aber es ist eine ganz andere Sache.

Es ist nicht so, dass man einfach den Servercode hochziehen und ihn einfach in die Cloud ziehen kann, worum ich sie als Benutzer jahrelang gebeten habe: „Warum ist das nicht in der Cloud?“ Jetzt weiß ich warum. Also haben wir ein neues Team zusammengestellt, das mit Scroll Viewport on Cloud begann. Und anfangs war es nur ein sehr schlampiges Projekt. Und ich erinnere mich an die erste Seite, auf der wir da oben waren wie: „Whoa, sieh dir diese Seite an, die wir veröffentlicht haben.“ Und von da an ging es weiter. Aber irgendwann mussten wir die beiden Teams wieder zusammenbringen. Und was wir einfach hätten sagen können: „Oh, dieser alte Viewport-Raum, was auch immer. Wir lassen es einfach da und machen dann einfach mit dem neuen weiter.“

Aber stattdessen nahm sich das Team Zeit und brachte die beiden Bereiche zusammen und ging die alten Inhalte im Viewport Server- und Rechenzentrumsbereich wirklich durch, um zu sagen: „Ist das alles noch relevant? Brauchen wir das immer noch?“ Es wurde also auf so erstaunliche Weise neu angeordnet. Einige unserer Teams sind wirklich gut darin geworden, diese Räume so einzurichten, dass ich reinkommen kann. Weil ich mit all unseren Teams zusammenarbeite, geh einfach rein und finde, was ich brauche, auch wenn ich nicht täglich in ihnen arbeite. Ich bin einfach so froh, ich bin so stolz auf das Team, dass es diesen Raum nicht einfach irgendwo schwinden lässt oder Angst hat, Inhalte zu löschen oder zu archivieren, was bei vielen Leuten der Fall ist.

Es ist wie: „Nein, was ist, wenn wir etwas verlieren?“ Es ist wie: „Nein, nein, nein, das haben wir hinter uns gelassen. Wir müssen es wirklich löschen.“ Das ist die Art von Einstellung, die wir brauchen: Unsere Teams teilen sich auf, erweitern und wachsen, und wir müssen uns dieser Inhalte bewusst sein. Denn auch hier gilt: Denkt an die neue Person, denkt an die Person, die etwas Neues lernt. Denke an die Person, die vielleicht eine Behinderung hat und versucht, die Inhalte zu bekommen, die sie braucht. Sie haben einfach nicht den Hintergrund, den Sie haben. Sie sind die Hälfte ihres Lebens in der Firma und wissen, wie man den Gedankenstapel durchwühlt, um genau das herauszuholen, was man will, aber sie nicht.

Henri Seymour:

Ja, und ich möchte nicht die Person sein, die sie jedes Mal fragen müssen, wenn sie Informationen benötigen: „Hey, kannst du das für mich finden?“ Nein, nein. Ich möchte ein System aufbauen, das bedeutet, dass ich nicht ständig dieselben Fragen beantworten muss. Das ist einer der Gründe, warum ich seitdem so viel interne Dokumentation mache [unhörbar 00:37:36]. Ich habe diese Frage einmal beantwortet, das reicht.

Matt Reiner:

Ja. Das ist eine wirklich gute Möglichkeit, alle Mitwirkenden an der Dokumentation zu motivieren. „Hey, weißt du, wie du diesen Teil unserer App einmal geschrieben hast und dann haben dich alle gefragt, wie er seitdem funktioniert? Dokumentiere es einfach einmal und ich verspreche, dass du es nie wieder beantworten kannst.“ Genau das ist eine gute Motivation.

Henri Seymour:

Ist es. Außerdem haben wir ein Team für Support-Modelle, also arbeite ich an den Storemaps und Personas, dem Produktentwicklungsteam. Und das ist dasselbe Team, das alle Support-Anfragen zu Storymaps und Personas erhält. Also ja, je besser wir das Produkt machen, desto besser machen wir die Dokumentation, desto weniger Zeit verbringen wir jeden Morgen damit. Und je mehr wir zu unseren regulären Jobs zurückkehren können.

Matt Reiner:

Exakt.

Henri Seymour:

Es war großartig, um uns dabei zu helfen, mit den Kunden in Kontakt zu bleiben und zu erfahren, was sie tun und welche Informationen sie benötigen, wenn sie unser Produkt verwenden. Du hast erwähnt, dass es zwar notwendig, aber wertvoll ist, von Zeit zu Zeit archivbasierte Dinge, Seiten in Confluence, zu löschen. Wenn du dir eine Seite ansiehst und dich fragst, ob es Zeit ist, sie zu öffnen, welche Art von Fragen stellst du dir?

Matt Reiner:

Nun, eine tolle Idee ist wie, sieh dir das Datum der letzten Änderung auf dieser Seite an. Das ist im Allgemeinen ein ziemlich gutes Zeichen für so etwas wie: „Schauen die Leute es sich überhaupt an?“ Wenn Sie Cloud Premium und höher nutzen, können Sie sich sogar auf jeder Seite einige großartige Kennzahlen ansehen, um zu sehen, wer sich das Ding ansieht? Ist das wertvoll? Wie sind die Aussichten? Genauso, wie Sie sich Ihre externe Website ansehen würden, um zu sehen, ob Ihre Inhalte wertvoll oder effektiv sind. Aber in der Regel haben wir eine Menge Trümmer übrig, die von der Produktentwicklung oder Teamaktivitäten übrig geblieben sind.

Wenn Sie beispielsweise im Marketing tätig sind und eine Kampagne von vor drei Jahren haben, benötigen Sie dann wirklich all diese detaillierten Seiten? Vielleicht behalten Sie die gesamte Kampagnenseite bei, vielleicht ist das nützlich, aber brauchen Sie wirklich alles? Wenn du gerne testest, brauchst du wirklich jeden Testplan, den du jemals erstellt hast? Wenn Sie im Rechtsteam sind, möchten Sie wirklich Ihre rechtlichen Bedingungen von vor 10 Jahren? Vielleicht, vielleicht, bin ich nicht in der Rechtsabteilung. Aber oft haben wir diese Angst vor, es ist wie Angst vor fehlenden Inhalten.

Es ist wie: „Oh nein, wenn ich das loswerde, werde ich es nicht haben.“ Aber Informationen, genau wie Sprache, genau wie die Art und Weise, wie wir denken, genau wie die Art und Weise, wie unsere Teams wachsen, sie ändern sich. Und deshalb müssen wir uns dessen bewusst sein. Da wir uns als Team verändern, sollten Sie damit rechnen, dass sich unsere Inhalte ändern. Und ein Teil davon ist, das alte Zeug loszuwerden. Es lohnt sich also immer. Wenn du es in Frage stellst, frag einen anderen Fachexperten und sage: „Hey, ich bin mir ziemlich sicher, dass wir das nicht mehr brauchen, oder wir sollten es überarbeiten. Was denkst du?“ Aber wenn niemand Bedenken hat, solltest du es wahrscheinlich löschen.

Henri Seymour:

Nein, das ist großartig. Ich bin ein großer Fan von Entrümpeln, auch von digitalem Entrümpeln. Es ist, ich möchte, dass die Leute Sachen finden und je weniger Stapel es gibt, desto einfacher wird es sein.

Matt Reiner:

Ja. Weil schlechte Informationen irgendwie weniger hilfreich sind als keine Informationen.

Henri Seymour:

Ja. Es ist, als würden sie auf eine Frage stoßen und sie sagen: „Oh, ich habe es auf diese Weise versucht.“ Ich sage: „Oh, dieser Weg funktioniert nicht mehr. Du wirst tun müssen... Wo hast du das aufgeschrieben gefunden? Ich werde auf dem Laufenden bleiben.“ Es ist...

Matt Reiner:

Ja.

Henri Seymour:

... neue Leute, die Sachen machen. Der beste Weg, um zu verstehen, wo Ihre Dokumentation ins Stocken gerät. Es ist genauso, als ob Sie nie verstehen werden, wie Ihre Produktdokumentation und Ihr Produkt selbst Ihre Benutzer im Stich lassen, bis sie zu Ihnen kommen und Ihnen sagen: „Warum kann ich das nicht tun?“

Matt Reiner:

Ja. Ja. Ja, diese Fähigkeit, jemanden neu in Ihr Team zu holen, ist so unglaublich. Und es ist fast schwierig, am ersten Tag des Onboardings zu sagen: „Du hast frische Augen, bitte nutze sie. Das wird als Inline-Kommentar bezeichnet, bitte platzieren Sie ihn überall.“ Ich erinnere mich, dass ich unser Mitarbeiterhandbuch für die Personalabteilung durchgesehen habe, das wir kurz vor meinem Beitritt gerade erstellt hatten. Und ich erinnere mich, dass sie mir sagten: „Falls es irgendwelche Fragen gibt, hat uns at erwähnt.“ Und ich hatte wirklich Angst davor. Aber wir haben viele Dinge korrigiert.

Zum Beispiel haben wir erwähnt, dass Sie diese Dinge tun auf... Wie wurde es nach HipChat genannt? Das Produkt, das so schnell lebte und starb.

Henri Seymour:

Ich glaube, den habe ich verpasst.

Matt Reiner:

Oh, die, die Atlassian gemacht und dann an Slack verkauft hat.

Henri Seymour:

Nun, wo fange ich überhaupt damit an?

Matt Reiner:

Wie geht es mir... Es war eine tolle App, sie hat mir sehr gut gefallen. Aber wir haben im Mitarbeiterhandbuch erwähnt, dass wir das verwenden sollten. Und ich sage: „Oh, ich glaube, wir verwenden jetzt Slack, wir sollten diesen Inhalt aktualisieren.“ Das sind Dinge, die die Personalabteilung niemals durchgehen und auffangen wird, aber deine neuen Mitarbeiter können das tun. Neue Mitarbeiter sind der beste Weg, um Ihnen zu sagen, ob Ihre Prozesse schlecht sind oder ob Ihre Inhalte besser sind. Vielleicht nicht schlecht, aber sie bringen etwas Neues ein. Deshalb haben wir sie ins Team aufgenommen. Und sie sollten vom ersten Tag an keine Angst haben, Fragen zu stellen oder Löcher in unseren bereits verkorksten oder gescheiterten Prozess zu bohren.

Henri Seymour:

Ja. Und ich kann den Vorteil der Tools in Confluence wirklich erkennen, wie dieser Inline-Kommentar. Auch wenn du nicht weißt, wie du diese Seite aktualisieren musst oder wie die neue Version aussehen soll. Es kommt gerade neu rein, du kannst sagen: „Oh, das ist komisch oder unvollständig, oder es könnte falsch sein.“ Es ist nur ein kleiner Kommentar. Du musst es nicht selbst ändern, sag einfach etwas. Hier ist eine Möglichkeit, sich zu äußern, ohne es selbst zu ändern. Und jemand, der es weiß, wird in der Lage sein, es für Sie zu ändern.

Ich habe mich gefreut, Sie über Informationsarchitektur sprechen zu hören. Das habe ich auch erst letztes Jahr kennengelernt. Haben Sie eine allgemeine Erklärung, was Informationsarchitektur ist und warum sie für die Dokumentation relevant ist?

Matt Reiner:

Oh, Informationsarchitektur ist, es gibt ganze Leute, Profis, deren gesamte Karriere reinkommt und einem hilft. Also ich gehöre nicht zu diesen Profis, ich spiele nur einen im Fernsehen. Im Wesentlichen zerlegt die Informationsarchitektur etwas, das eine Textwand wäre, in ein Informationsmuster, mit dem sich jeder Geist verbinden kann. Das ist das eigentliche und ultimative Ziel, und das beginnt damit, logische Teile aufzubrechen. Tatsächlich zerlegt man beim Schreiben rein technischer Texte den Inhalt in winzige, winzige Teile, oder einige technische Kommunikatoren sprechen von Informationatomen, wirklich winzigen Teilen.

Und wenn Sie das dann aufgeschlüsselt und gesagt haben: „Das sind separate Teile“, setzen Sie sie in einer Reihenfolge zusammen, die Sinn macht. Tatsächlich kannst du mit der Wiederverwendung von Inhalten in Confluence auch wirklich coole Sachen machen, indem du Include-Makros verwendest. Das neue Excerpt Include Macro ist in der Cloud sehr cool, weil du damit neue Sachen machen kannst. Aber es geht wirklich darum, all deine Inhalte auseinanderzunehmen und herauszufinden, in welcher Reihenfolge das alles abläuft? Was ist am wichtigsten? Was ist spezifischer? Was ist wichtig für alle? Was ist wichtig für nur wenige Menschen?

Und dann gehen Sie einfach nach unten, wie Sie es mit einer XML-Struktur oder einer anderen Art von Hierarchie tun würden, und ordnen Sie diese Informationen mithilfe Ihrer Leerzeichen, Ihrer Seiten, Ihrer Überschriften an. Und dann endlich Aufzählungszeichen und Absätze und so weiter.

Henri Seymour:

Danke, dass du das allgemein erklärt hast. Gibt es im Moment etwas, das Sie in Ihrer Arbeit erwähnen möchten, für das Sie die Leser interessieren würden?

Matt Reiner:

Ja, absolut. Ein großer neuer Aufwand für mich, weil ich wohl nur dieser Content Explorer bin. Ich mochte technische Inhalte, ich habe einige Marketinginhalte geschrieben. Ich habe angefangen zu sprechen, was mir Spaß macht. Ich durfte vor einem Live-Publikum sprechen, bevor... Nein, ich schätze ein paar, und dann ist die Welt aus gutem Grund zum Erliegen gekommen. Denn wenn man eine Menge Leute angreift, möchte man sichergehen, dass man sie nicht potenziell einem Risiko aussetzt. Ich habe also viel virtuell gesprochen.

Aber vor Kurzem habe ich erwähnt, dass wir an all diesen Best Practices für Rock the Docs gearbeitet haben. Deshalb haben wir diese Videoserie über die Best Practices von Confluence gestartet und es war sehr aufregend herauszufinden: „Okay, ich weiß also, wie man in Confluence ziemlich gute Inhalte erstellt, wie man diese Inhalte strukturiert. Können wir jetzt ein gutes Video machen?“ Und es stellt sich heraus, nein, zuerst nicht. Habe ein paar ziemlich schlechte gemacht oder solche, für deren Herstellung einfach viel zu viel Zeit in Anspruch genommen wurde. Und schließlich, wie Sie es bei jeder Art von Inhalten tun, haben wir endlich eine gute Struktur, einen guten Rhythmus. Und wir haben auch herausgefunden, über welche Dinge die Leute wirklich hören wollen?

Deshalb haben wir jetzt 16 davon auf unserem YouTube-Kanal entwickelt, die nur für Administratoren da sind, um sie mit deinen Nutzern zu teilen, die diese Fragen stellen. Oder vielleicht richten sie sich direkt an Nutzer, die einfach nur abonnieren und diese Dinge erhalten möchten. Aber es sind ungefähr acht Minuten mit genau so vielen Informationen, wie wir einpacken können und trotzdem gut lesbares Englisch sprechen. Und dann zeige einfach, wie macht man das in Confluence? Warum würdest du das in Confluence machen? Was sind die Dinge, die du in Confluence beachten solltest? Was sind die besten Möglichkeiten, Dinge in Confluence zu erledigen?

Wir haben auch gerade eine Reihe von Livestreams gestartet, bei denen wir versuchen, uns diese genauer anzusehen und dann die Leute live zuzuhören, Fragen zu stellen und Regie zu führen. Bisher waren diese wirklich großartig und wir planen, mehr davon zu tun. Je mehr Leute sich also darauf einlassen, desto mehr Richtung habt ihr alle, diesen Inhalten zu geben. Aber es waren neue Arten von Inhalten, und es ist aufregend zu sehen, okay, unsere gut geschriebenen Inhalte in Confluence kommen in einem neuen Format in die reale Welt. Das war cool und herausfordernd und lustig und gruselig zugleich.

Henri Seymour:

Ja. Das klingt nach einem wirklich aufregenden Projekt. Rock the Docs wird audiovisuell. Und ich kann...

Matt Reiner:

Das ist richtig.

Henri Seymour:

... stell dir vor was... Bringen Sie die Nutzer dazu, Ihnen das iterative Feedback zu geben, über das wir am Anfang gesprochen haben. Also ist das den Daumen hoch wert? Haben Sie Kommentare? Was können wir noch tun? Und besonders bei dieser Art von Live-Stream-Webinaren erhalten Sie den direkten Kontakt zu Ihren Benutzern, sodass Sie herausfinden können, was sie benötigen. Das ist fantastisch. Mal sehen, ob ich die mitbringen kann. Easy Agile begann speziell Anfang dieses Jahres, Scroll Viewport für die Cloud zu verwenden.

Matt Reiner:

Oh, cool. Oh, cool.

Henri Seymour:

Das war also tatsächlich eine große Verbesserung für uns.

Matt Reiner:

Oh, gut. Ja. Mir gefällt einfach, was das Cloud-Team herausbringt. Es ist so aufregend und so ausgefeilt und es ist, als ob jedes Team diesen Dokumentationsbereich hat, und Viewport, damit kannst du es veröffentlichen und du denkst: „Ah, sieht so toll aus. Wir sind so stolz darauf.“ Du kannst es auf jedem Gerät lesen. Es ist einfach so, als ob es die Magie ist, die jeder will, aber kein Team hat Zeit. Unsere sehr wenigen Teams haben Zeit, es so gut aussehen zu lassen, also ist es schön, dass Viewport einfach die Schwerarbeit erledigt.

Henri Seymour:

Wir haben den Confluence-Bereich, wir haben die Dokumentation. Wir müssen keine Website darüber erstellen. Es ist nur: „Mach weiter, bitte lass diese Website Wirklichkeit werden. Hier ist, was wir darauf brauchen. Hier ist die Struktur.“ Und meine Güte, es sieht jetzt viel besser aus, auch nur ästhetisch, es sieht im Haus sehr gut aus.

Matt Reiner:

Ja. Und es ist schön zu wissen, dass ein Designer den Abstand zwischen den Navigationselementen überschaut hat, um zu entscheiden, wie weit sie voneinander entfernt sein sollten. Und als Autor kann ich einfach sagen, es muss mir egal sein. Mir muss das egal sein. Ich kann Confluence-Makros und so reinwerfen, und sie sehen einfach toll aus, wenn sie veröffentlicht werden. Und ich weiß nicht wie oder warum, aber ich bin glücklich. Ich kann einfach weiterschreiben. Ja.

Henri Seymour:

Ja.

Matt Reiner:

Es wäre toll, jemanden von Easy Agile bei einem dieser Livestreams dabei zu haben. Denn worauf wir uns wirklich konzentrieren, ist einfach eine großartige Möglichkeit, Dinge in Confluence zu erledigen. Wir sind noch nicht in Jira eingestiegen. Ich bin nicht so ein Experte für Jira, aber ich habe darüber nachgedacht, weil dieser Inhalt noch nicht wirklich existiert. Aber es ist nicht unbedingt auf Apps oder K15t auf Apps ausgerichtet. Es ist einfach eine der besten Möglichkeiten, die du gefunden hast, um bestimmte Dinge in Confluence zu tun, und wir teilen sie einfach mit lebenden Menschen, und es macht eine Menge Spaß.

Henri Seymour:

Ja, das klingt toll. Ich habe die Parallele zwischen dem Einstieg in Jira und der Entwicklung von Jira-Apps und Confluence: „Ja, wir haben ein Wiki. Hier schreiben wir Sachen auf.“ Und es ist toll, Dinge wie „Da ist das Bildmaterial auf unserer Dokumentseite“ zu haben. Aber die mache ich nicht. Ich bin damit beschäftigt, Grafiken in einer Jira-App zu erstellen. Ich möchte nicht über diesen Abstand nachdenken. Ich muss meinen eigenen Abstand machen.

Matt Reiner:

Ja. Ja.

Henri Seymour:

Und es ist wirklich so, ich kann einfach schreiben, ich kann einfach das Produkt machen. Ich kann meinen Job besser machen, weil ich mich um diese anderen Dinge gekümmert habe, weil die Experten von K15t das möglich gemacht haben. Und ich hoffe, dass unsere Apps etwas Ähnliches für ihre Nutzer tun können. Das ist das, was wir brauchen, wir müssen nicht darüber nachdenken. Bringen Sie diese App mit und sie wird ein Problem für uns lösen. Sie hilft uns dabei, zu sehen, was wir brauchen, und unsere Informationen in Jira zu organisieren. Was wiederum eine andere Art von Information ist, aber.

Matt Reiner:

Ja, ja. Ja, es ist lustig. Ich habe mit einigen Leuten gesprochen, die den ganzen App-Teil von Confluence in Jira tatsächlich als App Hell beschrieben haben. Das ist ein Begriff, den ich gesehen habe, und ich kann nicht anders, als die Community zu lieben, weil wir uns alle diese Dinge einfallen lassen. Aber die Hölle ist die App, sie entsteht wirklich dadurch, dass man teilweise nicht versteht, was eine Plattform ist. Wenn Sie beispielsweise die Salesforce-Plattform verwenden, ja, das wird zur App-Hölle, wenn Sie wirklich wollen, dass Salesforce eine Marketingplattform ist. Weil Salesforce eine Vertriebsplattform ist. Aber dann gibt es Apps, und Salesforce verkauft sich zufällig sehr. Und dann ist es plötzlich eine Marketingplattform.

Das ist also ein wirklich interessanter Perspektivenwechsel für Leute, die an ein Tool gewöhnt sind, das nur eine Sache tut. Jeder denkt, Excel macht alles. Das tut es nicht, wir sollten es wirklich nur für Tabellenkalkulationen verwenden, Leute. Es ist keine Plattform für andere Dinge. Confluence ist wirklich gut in diesen Kerndingen, Jira ist wirklich gut in diesen Kerndingen. Und dann kommen diese Apps, um die Fragen zu beantworten, für die es keine Antworten gibt, und um die Dinge zu tun, die nicht getan werden können. Und das ist der Grund. Also ist es App Hell oder ist es App Heaven? Das ist die eigentliche Frage. Oder vielleicht ist es vielleicht App Purgatory, ich weiß es nicht. Ich denke, die Zuhörer entscheiden.

Henri Seymour:

Der ständige Strom von, und noch eine weitere App muss aktualisiert werden. Um fair zu sein, denke ich, dass dies derzeit kein Problem in der Cloud ist. Das ist ein ausschließlich vor Ort auftretendes Problem, der ständige Aktualisierungszyklus der Apps. Aber vielleicht nähern wir uns dem Ende des Fegefeuers.

Matt Reiner:

Ja. Ja. Ich glaube, wir steigen alle zusammen auf. Wir erreichen gerade gleichzeitig neue Höhen.

Henri Seymour:

Gibt es noch etwas, das du ansprechen möchtest, während wir über technische Dokumente sprechen?

Matt Reiner:

Ich schätze, ich gehe in die Zeit zurück, als ich an der Universität war. Ich hatte dort einen Manager, der uns in diesem Job auf dem Campus, den ich hatte, sagte: „Unsere Aufgabe ist es, Menschen mit den Ressourcen zu verbinden, die sie bereits umgeben. Du bist kein Lehrer, du bist nur hier, um Menschen miteinander zu verbinden.“ Und das ist mir wirklich im Gedächtnis geblieben. Und das ist im Grunde das, was wir alle tun. Egal, ob wir ein Produkt entwickeln, das Menschen mit Ressourcen verbindet, oder ob das die Ressource ist oder ob wir zur Dokumentation oder zu irgendwelchen Inhalten beitragen.

Wir versuchen wirklich, es den Leuten zu ermöglichen, etwas Größeres zu tun, etwas Höheres, das über unseren Inhalten, über unserem Produkt liegt. Es ist diese Sache, die ihnen wirklich wichtig ist, und jede Rolle, die wir spielen dürfen, und diese größere Sache, diese bessere Sache. Das ist es, worum es geht.

Henri Seymour:

Ja, das ist eine wirklich tolle Perspektive. Das ist wahrscheinlich auch eine wirklich tolle Sache, um das Ende des Podcasts abzurunden.

Matt Reiner:

Ich schätze schon.

Henri Seymour:

Ja. Vielen Dank, dass du zu uns gekommen bist, Matt, und dass du mit uns im Easy Agile Podcast über alles rund um technische Dokumentation gesprochen hast.

‍

‍