Ankündigung

Einklappen
Keine Ankündigung bisher.

Dokumentations-Helfer gesucht

Einklappen

Neue Werbung 2019

Einklappen
X
  • Filter
  • Zeit
  • Anzeigen
Alles löschen
neue Beiträge

  • Dokumentations-Helfer gesucht

    Ich würde gerne parallel zur Programmierung einer Objekt-Library eine Dokumentation führen, und dies "teil-manuell" machen (also ohne Dokumentor oder ähnlichen "automatischen" Werkzeugen (die nach meiner Erfahrung einiges einfach gar nicht erfassen, z.B. eval-Konstrukte oder variablen als assoziative indices).

    Stelle mir folgendes vor und würde gerne wissen, ob jemand Tools kennt, die dazu brauchbar sind:

    Doku von Methoden und Variablen (Properties)
    Wunsch:
    Während der Programmierung (manuelle) Eingabe der Variablennamen und Methodennamen in eine Liste (Name & Datei & Datei-Kurzbeschreibung, das mache ich im Moment mit einem Tabellenprogramm).

    Später dann einerseits Ausgabe nach Elementen (wo wurde das Element genutzt?) und Dateien (Welche Elemente wurden in der Datei benutzt?)

    Andereseits ein Check, ob die Liste noch stimmt (werden alle Elemente in der Liste auch in der notierten Datei genutzt?)

    Ferner wäre es schön, wenn das Tool "Multi-User fähig" wäre, also von verschiedenen Clients aus Einträge gemacht werden können (wenn man z.B. mehrere Maschinen gleichzeitig nutzt, von allen Maschinen Einträge vornehmen).

    Danke für Eure Hinweise
    Ich muss PHP im Kontext Home Automation nutzen (Vorgabe Hersteller und nicht zu ändern). Da kommt es leider ggf. auf ms an. Deshalb manche "seltsame" Frage.

  • #2
    du solltest dir mal phpDoc anschauen. Damit kannst du im PHP-Code dokumentieren und dir daraus eine Doku generieren lassen.

    Kommentar


    • #3
      Ich glaube bei deinem Entwicklungsverständnis brauchst du kein Tool sondern eine AI die den Code liest wie du ihn lesen würdest.
      [URL="https://gitter.im/php-de/chat?utm_source=share-link&utm_medium=link&utm_campaign=share-link"]PHP.de Gitter.im Chat[/URL] - [URL="https://raindrop.io/user/32178"]Meine öffentlichen Bookmarks[/URL] ← Ich habe dir geholfen ? [B][URL="https://www.amazon.de/gp/wishlist/348FHGUZWTNL0"]Beschenk mich[/URL][/B].

      Kommentar


      • #4
        Variablennamen sollten erklären, was sie enthalten - somit selbsterklärend sein. Methodennamen sollten erklären, was sie tun - somit selbsterklärend sein. Im Code sollte man nicht dokumentieren, was man erreichen will, sondern wieso genau dieser Ansatz dazu gewählt wurde, das zu erreichen. Eine Methodendokumentation sollte beschreiben, was die Methode kann und welche Parameter wie wirken.

        Ein Dokumentationstool für den Code ist somit nicht notwendig. PHPDoc kann (sollte?) man verwenden, um eine API zu dokumentieren (also theoretisch nur Interfaces).

        Für eine Architekturdokumentation wählt man dann andere Formen - das ist ja ziemlich unabhängig des Codes.
        [URL="https://github.com/chrisandchris"]GitHub.com - ChrisAndChris[/URL] - [URL="https://github.com/chrisandchris/symfony-rowmapper"]RowMapper und QueryBuilder für MySQL-Datenbanken[/URL]

        Kommentar


        • #5
          phpDOC setze ich schon ein, aber es liefert eben keine cross-refernces.

          @tr0y: AI?

          Nochmals zur Klarstellung:

          Es MUSS kein auto-tool sein, es geht mir eher darum, ein System zu bekommen, mit dessen Hilfe man "auf einen Blick" feststellen kann, was wo definiert ist und was wo verwendet wird. Dass das mit einer Menge manueller Arbeit verbunden ist (sein kann), ist mir klar.

          Di Auto-Funktion sehe ich eher als "Check-System", ob denbn die gepflegte Liste noch stimmt oder man z.B. etwas umbenannt (oder gelöscht) hat, ohne die Liste zu aktualisieren.

          Wie gesagt, ich mache die manuelle Arbeit im Moment mit Excel, aber das scheint mir nicht das richtige Tool für sowas zu sein, zumal immer nur ein Client an einem Sheet arbeiten kann, die Zusammenführung recht aufwändig ist.
          Ich muss PHP im Kontext Home Automation nutzen (Vorgabe Hersteller und nicht zu ändern). Da kommt es leider ggf. auf ms an. Deshalb manche "seltsame" Frage.

          Kommentar


          • #6
            Zitat von jwka61 Beitrag anzeigen
            @tr0y: AI?
            artificial intelligence, künstliche Intelligenz.

            Kommentar


            • #7
              Zitat von jwka61 Beitrag anzeigen
              phpDOC setze ich schon ein, aber es liefert eben keine cross-refernces.

              @tr0y: AI?

              Nochmals zur Klarstellung:

              Es MUSS kein auto-tool sein, es geht mir eher darum, ein System zu bekommen, mit dessen Hilfe man "auf einen Blick" feststellen kann, was wo definiert ist und was wo verwendet wird. Dass das mit einer Menge manueller Arbeit verbunden ist (sein kann), ist mir klar.
              So tief dokumentiert man nicht. Daten kapselt man nach aussen mit einem Interface ab.

              Zitat von jwka61 Beitrag anzeigen
              Di Auto-Funktion sehe ich eher als "Check-System", ob denbn die gepflegte Liste noch stimmt oder man z.B. etwas umbenannt (oder gelöscht) hat, ohne die Liste zu aktualisieren.
              Dann bau dir sowas selbst, Reflections und diverse Methoden zum Feststellen von definierten Klassen und/oder functions helfen dir dabei.

              Zitat von jwka61 Beitrag anzeigen
              Wie gesagt, ich mache die manuelle Arbeit im Moment mit Excel, aber das scheint mir nicht das richtige Tool für sowas zu sein, zumal immer nur ein Client an einem Sheet arbeiten kann, die Zusammenführung recht aufwändig ist.
              Das kann Office schon seit 2010: http://office.microsoft.com/de-de/ex...010342985.aspx
              [URL="https://gitter.im/php-de/chat?utm_source=share-link&utm_medium=link&utm_campaign=share-link"]PHP.de Gitter.im Chat[/URL] - [URL="https://raindrop.io/user/32178"]Meine öffentlichen Bookmarks[/URL] ← Ich habe dir geholfen ? [B][URL="https://www.amazon.de/gp/wishlist/348FHGUZWTNL0"]Beschenk mich[/URL][/B].

              Kommentar

              Lädt...
              X