Dokumentation af program?

[BSP]

Hej.

Jeg overtager snart vores hus med IHC - JUHHUU! 

Jeg er startet på første program, som er helt simpelt med kun tænd og sluk af lys. Så vi kan få lys i huset når vi flytter ind. 
I den forbindelse er jeg kommet til at tænke på hvordan jeg bedst/lettest dokumenter mit program, så jeg kan huske hvad jeg har lavet om 1 år eller hvis andre skal overtage programmet engang? Det er med at få startet på dokumentationen inden jeg kommer for langt, for ellers bliver det nok aldrig gjort....

Så hvordan gør I? 

[Lars Jacobsen]

Der er indbygget dokumentation i Visual programmet. Du skal bare huske at udfylde informationerne.

Det kan altid udskrives når man har fat i programmet, eller du kan benytte MikkelS 's meget fine onlineprogram til at danne en html/pdf med ledningsfarver. Søg og du skal finde.

[BSP]

14 timer siden, Lars Jacobsen skrev:

Der er indbygget dokumentation i Visual programmet. Du skal bare huske at udfylde informationerne.

Det kan altid udskrives når man har fat i programmet, eller du kan benytte MikkelS 's meget fine onlineprogram til at danne en html/pdf med ledningsfarver. Søg og du skal finde.

Du tænker på der hvor man kan udfylde lednings farve, indgang nr osv? Det har jeg været i gang med at udfylde.

Men hvad når programmet bliver mere avanceret. Laver I så en beskrivelse af virke måden? Hvordan en bestemt funktion er blevet lavet?
Det er nogle meget avancerede FB jeg har læst om her på forumet, og de ikke beskrives for at kunne huske hvordan det er lavet?

[Lars Jacobsen]

Virkemåden af hjemmeprogrammerede FB´r er der ikke mange steder at dokumentere.

Jeg anbefaler (og plejer så vidt muligt at jeg selv huser det) at udfylde beskrivelsen og hjælpeteksten til hver ind/ud gang samt diverse indstillinger. Så er der rimelig nemt at forstå hvad FB´n gør, og hvad den kan benyttes til (også efter 2 -3 år). Men selve koden inde i FB´n den er der sjældent meget dokumentation af. Jo jo, igen hvis man husker at udfylde lidt beskrivelses felter og navngive programstumperne lidt mere sigende end bare default navnet "program".

[TheDexterTeam]

På ‎24‎-‎04‎-‎2017 at 17:32 , Lars Jacobsen skrev:

Der er indbygget dokumentation i Visual programmet. Du skal bare huske at udfylde informationerne.

Det kan altid udskrives når man har fat i programmet, eller du kan benytte MikkelS 's meget fine onlineprogram til at danne en html/pdf med ledningsfarver. Søg og du skal finde.

Lars: har du en ide til hvad der kan være galt, når jeg indlæser min vis-fil - jeg får kun tekst ud hvor indholdet er alle de felter, der mangler oplysninger.

Fejlen har jeg haft længe men du ville jeg lige prøve at indlæse igen da du lige nævnte Mikkel´s program ;-)

Jeg får dog "også" denne fejlkode i starten af printet:"Warning: Invalid argument supplied for foreach() in /customers/0/7/8/jemi.dk/httpd.www/ihc/docs/report.php on line 143 Warning: Invalid argument supplied for foreach() in /customers/0/7/8/jemi.dk/httpd.www/ihc/docs/report.php on line 143 Warning: Invalid argument supplied for foreach() in /customers/0/7/8/jemi.dk/httpd.www/ihc/docs/report.php on line 143"

Hilsen Torben

[Lars Jacobsen]

Nej det må Mikkel nok svare på, men prøv at vedhæfte dit projekt/program her, så kan vi da kikke på om det virker normalt og vi kan finde årsagen.

[BSP]

Tak for alle svarene!

Beklager det sene "TAK" jeg har været ramt af flytte stress/kaos, så der har ikke været tid til at surfe.