jumibot/informe_deliberativa

Bericht einer deliberativen Aufgabe

Eine deliberative Aufgabe (recherchieren, deliberieren oder entwerfen; „Sieben Aufgabentypen in drei Familien“, 223) erstellt einen Bericht und die daraus resultierenden Aufgaben („Eine deliberative Aufgabe gibt einen Bericht und die daraus resultierenden Aufgaben“, 218). Ihre Dilemmas leben im Bericht, stets aktuell mit jeder Antwort des Eigentümers, und nicht in der Warteschlange oder in einer anderen Datei. Was zu einer anderen Aufgabe gehört, wird als Trennung vorgeschlagen; beim Schließen gehen die noch offenen Punkte in ihre jeweilige Aufgabe über („In einer deliberativen Aufgabe wird, was zu einer anderen Aufgabe gehört, als Trennung vorgeschlagen“, 221). Eine deliberative Aufgabe testet nichts und ändert nur ihren Bericht: Was umgesetzt werden muss, erledigen die von ihr erstellten Aufgaben.

Diese Skill beschreibt, was der Bericht enthält, wie seine Fragen geschrieben werden und wie jede Iteration abläuft. Der Generator, die Ressourcen, die Themen und die Prüfung sind die von crear_documentos, das zusammen mit dieser Skill gelesen wird. Sie ist die Skill des Agenten der deliberativen Familie, sobald dieser existiert („Spezialisierte Agenten, einer pro Aufgabenfamilie“, 304); solange wird sie vom Unteragenten der Aufgabe geladen.

Der Leser ist der Eigentümer, der entscheiden muss. Der Bericht erspart ihm Arbeit: Was entschieden werden muss, wird zuerst gezeigt, jede Frage wird mit einem Buchstaben beantwortet, und die Empfehlung ist auf einen Blick erkennbar. Gute Kommunikation ist ein Ziel der SF (Entscheidung 231).

Wo der Bericht abgelegt wird

• In einem in die SF eingebundenen Projekt im Verzeichnis sf/informes/ („Die Dokumente der SF liegen im Ordner sf/“, 203).
• In der SF selbst in docs/referencias/reports/, bis über die Verschiebung nach sf/ entschieden ist (Frage 13 des Berichts „Aufgabentypen“, in Aufgabe 303).

Der Dateiname ist das Thema, nicht die Aufgabennummer: Tipos de tarea.md und seine .html. Ersetzte Versionen werden im selben Ordner nach _respaldo/ verschoben.

Modell: der Bericht docs/referencias/reports/Tipos de tarea.md der SF (Aufgabe 274). Falls auf dem Rechner vorhanden, wird er als Beispiel gelesen; sein Inhalt wird nicht kopiert. Die leere Vorlage liegt unter assets/plantilla-informe.md.

Aufbau

Die Abschnitte erscheinen stets in dieser Reihenfolge, mit diesen {#id}, damit der Eigentümer weiß, wo er suchen muss, und Aufgaben darauf verlinken können:

1. Zusammenfassung {#resumen}. Die Schlussfolgerung in zwei bis drei kurzen Absätzen: Was wird vorgeschlagen, worauf stützt es sich, wie viele Fragen sind noch offen und wo. Wenn eine Skizze das Ganze verdeutlicht, gehört sie hierher. Endet mit einem Sprung zu dem, was entschieden werden muss ([Zu den N Fragen](#por-decidir){: .salto}).
2. Die Analyse, in einem oder mehreren eigenen Abschnitten: Was wurde untersucht und was wird vorgeschlagen, mit Begründung. Zuerst das Vorgeschlagene oder Geschlussfolgerte, auch wenn es sich aus dem Rest ergibt; dann die Bewertung, die es stützt, und seine Grenzen. Hier gehören Karten, Skizzen und Tabellen zum Thema hin.
3. Entschieden {#decidido}. Eine Tabelle mit den Entscheidungen des Eigentümers, die diese Aufgabe festlegt: Nr. | Entscheidung | Was hier festgelegt wird. Jede Entscheidung ist vor ihrem Erscheinen in ihrer eigenen Entscheidungsdatei festgehalten.
4. Noch zu entscheiden {#por-decidir}. Die offenen Fragen in einem ::: preguntas-Block. Bei vielen Fragen werden sie in Blöcke unterteilt, jeder in seinem eigenen Abschnitt ({#por-decidir-<destino>}), nach Wichtigkeit oder nach dem Ort, an den sie bei einer Trennung gehen würden; jeder Block beginnt mit einem Satz, der sagt, was er zusammenfasst, und einem Sprung zu seiner Trennung.
5. Trennen {#separar}. Die vorgeschlagenen Abspaltungen: eine Karte pro Abspaltung ({: #a-<destino>}), mit dem, was mitgenommen wird (die Fragen, jeweils mit Link) und wohin (eine neue Aufgabe, ein Schritt einer bestehenden Aufgabe oder /sf_split). Wenn die Art der Trennung gewählt werden muss, ist auch das eine Frage.
6. Aufgaben {#tareas}. Die resultierenden Aufgaben: Aufgabe | Typ | Was sie macht. Bereits existierende Aufgaben mit ihrer Nummer.

Anhänge am Ende, nur falls nötig: Quellen (::: fuentes), vollständige Daten, vorgeschlagener Text für ein Dokument, das von einer anderen Aufgabe geändert wird.

Wenn die Analyse nichts zu entscheiden, zu trennen oder zu erstellen übrig lässt, werden diese Abschnitte weggelassen; die übrigen ändern ihre Reihenfolge nicht.

Kopfzeile: antetitulo mit „Projekt · Bericht zu <Analyse, Design oder Forschung> · “, lema, subtitulo mit dem, was der Bericht beantwortet, version, estado („Vorschlag · Aufgabe N“, „Entschieden · Aufgabe N“…), portada: oscura, destino: proyecto, herramientas, menu: secciones (der Eigentümer springt zwischen Abschnitten), tipo („Analysebericht“, „Designbericht“, „Forschungsbericht“) und pie mit der Aufgabe, von welchem Teil der Bericht stammt und wer entscheidet.

Die Fragen

Jede Frage ist eine Karte von ::: preguntas, die Ressource „Frage mit Optionen“ aus crear_documentos:

::: preguntas 2 plegables

### 1 · Wie „nur sein Dokument“ eingehalten wird {recomendada=A} {: #p1}

Heute überwacht das nichts: Jeder Schritt kommt in die Aufgabe.

Option A
:   Die Aufgabe deklariert ihr Dokument mit einem Befehl, und `cerrar` verweigert sich, wenn der Branch andere Dateien berührt.

Option B
:   Nur die Regel, schriftlich in der Orchestrierung.

Empfehlung
:   **A.** Sie wird mit einem Befehl umgesetzt, nicht durch das Gedächtnis des Prinzipals.

:::

• Eine Entscheidung pro Frage, mit einem Titel, der sie benennt, und einer Nummer nach Wichtigkeit (1 die wichtigste). Die Nummer und der Anker {: #pN} ändern sich nicht, auch wenn die Frage entschieden oder getrennt wird: Die Schritte der Aufgaben zitieren sie damit („Entscheiden … (Frage 5) (Bericht „Aufgabentypen“, 274)“).
• Kontext in ein bis zwei Sätzen, nur falls zur Wahl nötig: Was passiert heute oder warum muss entschieden werden.
• Zwei oder drei Optionen, Opción A, Opción B…, jede mit den Implikationen in ein bis zwei Sätzen. „Wie heute“ ist eine Option, wenn sie es wirklich ist.
• Empfehlung mit Begründung in einem Satz und recomendada=A im Titel, um sie hervorzuheben. Jede offene Frage hat eine Empfehlung; der Generator warnt, wenn sie fehlt.
• Status, stets aktuell mit jeder Antwort:
  • estado=abierta (Standard): Die Antwort wird erwartet;
  • estado=decidida elegida=B: Mit einem Feld Decisión, das die gewählte Option mit ihren Nuancen und der Nummer der registrierten Entscheidung angibt; die gewählte Option wird markiert, die anderen werden grau;
  • estado=separada destino=tarea_303: Wurde zu einer anderen Aufgabe verschoben (der _ wird in der Markierung als Leerzeichen gelesen). Bleibt im Bericht, damit die Zielaufgabe darauf verlinken kann.
• Fragen, die von einer anderen abhängen, werden im Kontext genannt, mit Link zur anderen.

Wenn eine Frage entschieden oder getrennt wird, bleibt ihre Karte im Block mit dem neuen Status, und die Entscheidung kommt auch in die Tabelle „Entschieden“. Die Zusammenfassung sagt, wie viele noch offen sind.

Jede Iteration

Jede Antwort des Eigentümers oder jeder Fortschritt in der Analyse, der den Bericht ändert, ist eine Iteration:

1. Sicherung der zu ersetzenden Version: python -I -X utf8 <skills>/crear_documentos/scripts/respaldar.py <bericht>.md <grund> („Bevor ein Dokument ersetzt wird, wird es in _respaldo/ gesichert“, 217).

2. Änderungen schreiben: den Status der beantworteten Fragen, „Entschieden“, die Trennungen und Aufgaben sowie die Zusammenfassung. Version erhöhen in der Kopfzeile (2.5 → 2.6; die erste Zahl bei Änderung der Berichtsstruktur) und estado aktualisieren.

3. HTML neu generieren im selben Commit („Jede Änderung einer .md-Datei generiert ihr HTML neu“, 220):

   python -I -X utf8 <skills>/informe_deliberativa/scripts/informe_to_html.py <bericht>.md
   

4. Nach develop übernehmen ohne Branch, da es ein neues Dokument ist („Neue Dokumente gehen bei jeder Iteration nach develop und werden im Browser angeboten“, 216), mit dem Befehl, der dies tut, sobald er existiert („Neue Dokumente bei jeder Iteration nach develop und im Browser öffnen“, 297).

5. HTML im Browser öffnen anbieten, mit der neuen Version.

Prüfung

Die von crear_documentos („Prüfung“) sowie:

• jede offene Frage hat mindestens zwei Optionen und eine empfohlene; keine entschiedene ohne elegida und keine getrennte ohne destino;
• die Zählungen der Zusammenfassung (offene Fragen, Trennungen, Aufgaben) stimmen mit den Abschnitten überein;
• jeder Link zu einer Frage (#pN) oder zu einer Trennung (#a-…) existiert;
• die Tabelle „Entschieden“ enthält nur bereits registrierte Entscheidungen.