(9 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
{{Mbox | {{Mbox | ||
| type = notice | | type = notice | ||
− | | text = Dieser Artikel und die darin enthaltenen Informationen richten sich | + | | text = Dieser Artikel und die darin enthaltenen Informationen richten sich an Mitarbeiter des IMT. |
}} | }} | ||
In dieser Anleitung erfahren Sie, welche Schritte beim Überarbeiten eines Artikels durchgeführt werden. | In dieser Anleitung erfahren Sie, welche Schritte beim Überarbeiten eines Artikels durchgeführt werden. | ||
Zeile 7: | Zeile 7: | ||
==Was ist zu tun?== | ==Was ist zu tun?== | ||
===1st Level=== | ===1st Level=== | ||
− | # Dieser Prozess wird durch | + | # Dieser Prozess wird durch durch eine Ticketbearbeitung im [https://otrs.uni-paderborn.de/ OTRS] gestartet. Dem ganzen sollte eine [[Hilfe:Änderungen registrieren|Registrierung einer Überarbeitung]] zuvorgegangen sein. Wir setzen also voraus: |
− | + | ## es existiert ein Artikel im IMT:HilfeWiki | |
− | ## | + | ## es existiert ein Ticket im OTRS |
− | ## | + | ## die beiden sind miteinander verknüpft. (Für Details siehe [[Hilfe:Änderungen registrieren|Änderungen registrieren]]) |
− | # | + | ## der Artikel im Wiki ist als einer von drei Bearbeitungstypen klassifiziert (siehe dazu detailiert unsere [[#Klassifizierungen|Klassifizierungen]]) |
− | + | # Eine Klassifizierung als {{tl|Faulty}} ist mit hoher Priorität zu bearbeiten. | |
− | # | + | ## Falls noch nicht geschehen, ändern Sie bitte den Tickettitel und fügen Sie den Begriff "FAULTY" zwischen "[IMT:HilfeWiki]" und dem Rest des Betreffs |
− | + | # Reagieren und bearbeiten Sie nun gemäß der Klassifizierung (siehe dazu [[Hilfe:Artikel überarbeiten#Sichtung 1st Level|Sichtung 1st Level]]) den Artikel im Wiki. Beachten Sie die Änderungshinweise im OTRS-Ticket (ggf. auch die in den anhängenden Notizen) | |
− | + | ## Sollten Sie die Artikelbearbeitung nicht in einem Vorgang beenden können, notieren Sie den Arbeitsstand im Ticket | |
− | ## | + | # Nach Beendigung der Bearbeitung stellen Sie sich die Frage, ob der Artikel veröffentlich werden kann |
− | #Reagieren Sie nun gemäß der Klassifizierung (siehe dazu) | + | ## Bei vorliegender Veröffentlichungsfreigabe, bitte weiter mit [[#Ende_der_.C3.9Cberarbeitung|Ende der Überarbeitung]] |
− | ## | + | ## Wenn nicht, übergeben Sie den Vorgang an den Serviceowner/2nd level. Dazu |
− | #Schreiben | + | ### Schreiben Sie eine Ticketnotiz mit dem Betreff ''"Übergabe an SO"'' oder ''"Übergabe an 2nd level"'' und einer Information, was getan wurde und was vom Service Owner/2nd level für Angaben/Tätigkeiten erwartet werden |
− | # | + | ### Verschieben Sie das Ticket in die entsprechende 2nd Level Queue |
− | ===2nd Level=== | + | |
+ | === Service Owner / 2nd Level === | ||
# Dieser Prozess wird durch ein Ticket in der jeweiligen 2nd Level Queue eingeleitet | # Dieser Prozess wird durch ein Ticket in der jeweiligen 2nd Level Queue eingeleitet | ||
− | # Reagieren Sie nun gemäß der Klassifizierung (siehe dazu) | + | # Reagieren Sie nun gemäß der Klassifizierung (siehe dazu unsere [[#Klassifizierungen|Klassifizierungen]]) |
− | # Schreiben | + | # Entscheiden Sie, ob Sie selbst Änderungen am HilfeWiki-Artikel vornehmen wollen. Wenn ja, editieren Sie den Artikel |
− | # Dispatch des Tickets | + | # Schreiben Sie in jedem Fall eine Ticketnotiz mit |
+ | ## Betreff '''Übergabe an 1st level''' | ||
+ | ## Notiztext: Was Sie getan haben und was Sie vom 1st level an Tätigkeit wünschen/ | ||
+ | # Dispatch des Tickets in die Hilfewiki Queue | ||
# Prozess startet neu bei '''1st Level Schritt 2''' | # Prozess startet neu bei '''1st Level Schritt 2''' | ||
− | == | + | === Ende der Überarbeitung === |
− | + | # Zur Beendigung des Überarbeitungsprozesses entfernen Sie bitte die Ticketverknüpfung | |
− | + | ## dazu editieren Sie den HilfeWiki-Artikel und entfernen das Template {{tl|otrs}}. Als Bearbeitungshinweis/-kommentar notieren Sie bitte ''"Überarbeitung abgeschlossen"'' | |
− | + | ## Schließen Sie das entsprechende Ticket | |
− | + | ||
− | + | ||
− | + | == Prozessdiagramm == | |
− | == | + | === 1st level === |
− | + | [[Image:Diagram Prozess - Überarbeitung 1st level.png|Flowchart Überarbeitungsprozess Teil 1st level]] | |
+ | |||
+ | === Service Owner / 2nd level === | ||
+ | [[Image:Diagram Prozess - Überarbeitung 2nd level.png|Flowchart Überarbeitungsprozess Teil 1st level]] | ||
+ | |||
+ | == Klassifizierungen == | ||
+ | Unser System kennt drei für die Überarbeitung relevante Klassifizierungen: | ||
;{{tl|Stub}} | ;{{tl|Stub}} | ||
:Der Artikel (Name/ Platz/ Verlinkung) ist bereits vorhanden, muss aber noch mit Inhalt gefüllt werden. | :Der Artikel (Name/ Platz/ Verlinkung) ist bereits vorhanden, muss aber noch mit Inhalt gefüllt werden. | ||
+ | :Stellen Sie die Inhalte bereit und klassifizieren Sie ggf. den Artikel als {{tl|Draft}} | ||
;{{tl|Draft}} | ;{{tl|Draft}} | ||
− | :Der Artikel ist größtenteils fertig und mit Inhalt gefüllt. Er sollte nun überprüft werden. | + | :Der Artikel ist größtenteils fertig und mit Inhalt gefüllt. Er sollte nun überprüft werden. Es existiert kein indirekter Text der Form "Hier bitte Screenshot" oder "Noch Installationsvorgang erklären" mehr. |
− | + | :Sichten Sie den Artikel und setzen Sie bei Bedarf eine der oben angegebenen Klassifizierung und arbeiten diese ab. | |
− | |||
;{{tl|Faulty}} | ;{{tl|Faulty}} | ||
:Der Artikel enthält gravierende Fehler oder falsche Abschnitte. Er muss dringend übnerarbeitet werden. | :Der Artikel enthält gravierende Fehler oder falsche Abschnitte. Er muss dringend übnerarbeitet werden. | ||
+ | :Bearbeiten Sie wenn möglich die falschen Abschnitte. Ist kein Feedback mehr nötig (durch den 2nd Level) können Sie die Markierung entfernen. | ||
+ | |||
+ | Darüber hinaus können diese Klassifizerungen parallen zur Überarbeitung existieren: | ||
;{{tl|Untested}} | ;{{tl|Untested}} | ||
:Der Artikel ist fertig und entspricht in Layout / Sprache den Anforderungen. Die Informationen im Artikel können jedoch nicht überprüft werden (z.B. fehlende Hardware / Software) | :Der Artikel ist fertig und entspricht in Layout / Sprache den Anforderungen. Die Informationen im Artikel können jedoch nicht überprüft werden (z.B. fehlende Hardware / Software) | ||
− | + | :Wenn positives Feedback im erweiterten Kollegenkreis existiert, kann die Markierung entfernt werden. postives Feedback kann in einem entsprechendem OTRS Ticket gesammelt oder von Kunden und Mitarbeitern eingeholt werden. Sollte mehrheitlich negatives Feedback gegeben werden, ändern Sie die Markierung in {{tl|Faulty}} oder {{tl|Draft}}. | |
− | + | ;{{tl|Deprecated}} | |
− | + | :Der Artikel oder der entsprechende Dienst ist veraltet und wird nicht mehr gepflegt. | |
− | + | :Prüfen Sie, ob der Artikel nach gegebener Zeit gelöscht werden kann. | |
− | + | ;{{tl|Deprecated template}} | |
− | + | :Wird nicht direkt im Artikel sondern in einem im Artikel verwendeten Template gesetzt. Das setzende Template ist veraltet und sollte entfernt oder ersetzt werden. | |
− | + | :Entfernen oder ersetzen Sie das veraltete Template. Nähere Informationen finden Sie auf der Seite des betroffenen Templates. | |
− | + | ||
− | + | '''Anmerkung:''' der durchschnittliche Artikel mit abgeschlossener Bearbeitung trägt keinerlei Klassifizierung | |
− | :Wenn positives Feedback im erweiterten Kollegenkreis existiert, kann die Markierung entfernt werden. postives Feedback kann in einem entsprechendem OTRS Ticket gesammelt oder von Kunden und Mitarbeitern eingeholt werden. Sollte mehrheitlich negatives Feedback gegeben werden, ändern Sie die Markierung in {{tl|Faulty}} oder {{tl| | ||
− | ;{{tl| | ||
− | : | ||
− | |||
− | |||
− | |||
− | |||
− | ;{{tl| | ||
− | : | ||
− | |||
− | |||
− | |||
− | : | ||
− | |||
− |
Aktuelle Version vom 8. September 2014, 12:16 Uhr
Dieser Artikel und die darin enthaltenen Informationen richten sich an Mitarbeiter des IMT. |
In dieser Anleitung erfahren Sie, welche Schritte beim Überarbeiten eines Artikels durchgeführt werden.
Was ist zu tun?[Bearbeiten | Quelltext bearbeiten]
1st Level[Bearbeiten | Quelltext bearbeiten]
- Dieser Prozess wird durch durch eine Ticketbearbeitung im OTRS gestartet. Dem ganzen sollte eine Registrierung einer Überarbeitung zuvorgegangen sein. Wir setzen also voraus:
- es existiert ein Artikel im IMT:HilfeWiki
- es existiert ein Ticket im OTRS
- die beiden sind miteinander verknüpft. (Für Details siehe Änderungen registrieren)
- der Artikel im Wiki ist als einer von drei Bearbeitungstypen klassifiziert (siehe dazu detailiert unsere Klassifizierungen)
- Eine Klassifizierung als {{Faulty}} ist mit hoher Priorität zu bearbeiten.
- Falls noch nicht geschehen, ändern Sie bitte den Tickettitel und fügen Sie den Begriff "FAULTY" zwischen "[IMT:HilfeWiki]" und dem Rest des Betreffs
- Reagieren und bearbeiten Sie nun gemäß der Klassifizierung (siehe dazu Sichtung 1st Level) den Artikel im Wiki. Beachten Sie die Änderungshinweise im OTRS-Ticket (ggf. auch die in den anhängenden Notizen)
- Sollten Sie die Artikelbearbeitung nicht in einem Vorgang beenden können, notieren Sie den Arbeitsstand im Ticket
- Nach Beendigung der Bearbeitung stellen Sie sich die Frage, ob der Artikel veröffentlich werden kann
- Bei vorliegender Veröffentlichungsfreigabe, bitte weiter mit Ende der Überarbeitung
- Wenn nicht, übergeben Sie den Vorgang an den Serviceowner/2nd level. Dazu
- Schreiben Sie eine Ticketnotiz mit dem Betreff "Übergabe an SO" oder "Übergabe an 2nd level" und einer Information, was getan wurde und was vom Service Owner/2nd level für Angaben/Tätigkeiten erwartet werden
- Verschieben Sie das Ticket in die entsprechende 2nd Level Queue
Service Owner / 2nd Level[Bearbeiten | Quelltext bearbeiten]
- Dieser Prozess wird durch ein Ticket in der jeweiligen 2nd Level Queue eingeleitet
- Reagieren Sie nun gemäß der Klassifizierung (siehe dazu unsere Klassifizierungen)
- Entscheiden Sie, ob Sie selbst Änderungen am HilfeWiki-Artikel vornehmen wollen. Wenn ja, editieren Sie den Artikel
- Schreiben Sie in jedem Fall eine Ticketnotiz mit
- Betreff Übergabe an 1st level
- Notiztext: Was Sie getan haben und was Sie vom 1st level an Tätigkeit wünschen/
- Dispatch des Tickets in die Hilfewiki Queue
- Prozess startet neu bei 1st Level Schritt 2
Ende der Überarbeitung[Bearbeiten | Quelltext bearbeiten]
- Zur Beendigung des Überarbeitungsprozesses entfernen Sie bitte die Ticketverknüpfung
- dazu editieren Sie den HilfeWiki-Artikel und entfernen das Template {{otrs}}. Als Bearbeitungshinweis/-kommentar notieren Sie bitte "Überarbeitung abgeschlossen"
- Schließen Sie das entsprechende Ticket
Prozessdiagramm[Bearbeiten | Quelltext bearbeiten]
1st level[Bearbeiten | Quelltext bearbeiten]
Service Owner / 2nd level[Bearbeiten | Quelltext bearbeiten]
Klassifizierungen[Bearbeiten | Quelltext bearbeiten]
Unser System kennt drei für die Überarbeitung relevante Klassifizierungen:
- {{Stub}}
- Der Artikel (Name/ Platz/ Verlinkung) ist bereits vorhanden, muss aber noch mit Inhalt gefüllt werden.
- Stellen Sie die Inhalte bereit und klassifizieren Sie ggf. den Artikel als {{Draft}}
- {{Draft}}
- Der Artikel ist größtenteils fertig und mit Inhalt gefüllt. Er sollte nun überprüft werden. Es existiert kein indirekter Text der Form "Hier bitte Screenshot" oder "Noch Installationsvorgang erklären" mehr.
- Sichten Sie den Artikel und setzen Sie bei Bedarf eine der oben angegebenen Klassifizierung und arbeiten diese ab.
- {{Faulty}}
- Der Artikel enthält gravierende Fehler oder falsche Abschnitte. Er muss dringend übnerarbeitet werden.
- Bearbeiten Sie wenn möglich die falschen Abschnitte. Ist kein Feedback mehr nötig (durch den 2nd Level) können Sie die Markierung entfernen.
Darüber hinaus können diese Klassifizerungen parallen zur Überarbeitung existieren:
- {{Untested}}
- Der Artikel ist fertig und entspricht in Layout / Sprache den Anforderungen. Die Informationen im Artikel können jedoch nicht überprüft werden (z.B. fehlende Hardware / Software)
- Wenn positives Feedback im erweiterten Kollegenkreis existiert, kann die Markierung entfernt werden. postives Feedback kann in einem entsprechendem OTRS Ticket gesammelt oder von Kunden und Mitarbeitern eingeholt werden. Sollte mehrheitlich negatives Feedback gegeben werden, ändern Sie die Markierung in {{Faulty}} oder {{Draft}}.
- {{Deprecated}}
- Der Artikel oder der entsprechende Dienst ist veraltet und wird nicht mehr gepflegt.
- Prüfen Sie, ob der Artikel nach gegebener Zeit gelöscht werden kann.
- {{Deprecated template}}
- Wird nicht direkt im Artikel sondern in einem im Artikel verwendeten Template gesetzt. Das setzende Template ist veraltet und sollte entfernt oder ersetzt werden.
- Entfernen oder ersetzen Sie das veraltete Template. Nähere Informationen finden Sie auf der Seite des betroffenen Templates.
Anmerkung: der durchschnittliche Artikel mit abgeschlossener Bearbeitung trägt keinerlei Klassifizierung