PHP-Entwicklung

PHP-Entwicklung

Posts 11-12 of 12
  • Dr. Daniel Pozzi
    Dr. Daniel Pozzi    Premium Member   Group moderator
    The company name is only visible to registered members.
    Re^2: Handbuch aus Quellcode generieren?
    1) Bin gerade dabei so ein Skript zu schreiben, das eigene Annotationen liest und alles zusammen in ein Dokument (text)m klatscht. Mal sehen, ob es das bringt.

    2) ICONIX und Powerdesigner? Noch nie gehört. Und das ganze ist für ein privates Projekt mit sehr wenig Resourcen, nix für Unternehmen mit Wasserkopf.
    • 19 Jun 2009, 5:49 pm
  • Ferdinand Kestennus
    Ferdinand Kestennus
    The company name is only visible to registered members.
    Re^3: Handbuch aus Quellcode generieren?
    Dr. Daniel Pozzi schrieb:
    1) Bin gerade dabei so ein Skript zu schreiben, das eigene Annotationen liest und alles zusammen in ein Dokument (text)m klatscht. Mal sehen, ob es das bringt.
    Nochmal: Wer soll dieses Dokument lesen ? Für wen ist es bestimmt ?
    Benutzerhandbuch oder Systemdokumentation ? Das ist hier die Frage.

    2) ICONIX und Powerdesigner? Noch nie gehört. Und das ganze ist für ein privates Projekt mit sehr wenig Resourcen, nix für Unternehmen mit Wasserkopf.
    Jedes "Programm" soll ja einen Sinn haben. Dieser besteht regelmäßig darin, einem Akteur einen Mehrwert zu liefern.
    Niemand klimpert aus langeweile auf der Tastatur herum oder spielt mit der Maus, um irgendwelche Reaktionen zu erhalten.
    Für jede Aktion, welche der Akteur auslöst, erwartet er ein entsprechendes Ergebnis. Diese "Anforderungsanalyse" kann sehr gut mit ICONIX erfolgen und hat mit "Wasserkopf" nichts zu tun. Selbst wenn ich ein klitzekleines Problem für den eigenen Bedarf lösen möchte, muß ich zuvor erst überlegen, was ich erreichen möchte.

    Wenn dann alles beispielsweise mit dem Powerdesigner entwickelt wird, ergibt sich zwangsläufig sowohl ein Benutzerhandbuch als auch eine Systemdokumentation. Dem stehen Annotations im Quelltext nicht entgegen.

    Mit diesem Thema sollte sich jeder Softwareentwickler auseinandersetzen. Mein Tip: einfach mal google'n und sich schlau machen. Es kann nur von Vorteil sein.

    MfG

    Ferdinand Kestennus
    • 24 Jun 2009, 12:31 am