IHC projekt dokumentation

[Mikkel Skovgaard]

Ny version af IHC Dokumentation værktøjet: http://jemi.dk/ihc/docs

 

- Nu med "link" visning

- Funktionsoversigt visning

 

Test gerne

[Lars Jacobsen]

Har nu testet med mit eget projekt og ja kabelfarverne vises nu med den samme farve som teksten angiver.

Har bare nogle som ser lidt mærkelige ud som jeg skal havde kikket nærmere på. Der kan jo ikke passe at den brune leder er koblet til flere output på samme tid.

(Kan måske skyldes jeg er kommet til at nummerere to kabler med samme kabelnummer ?) 

 

 

Og så her jeg nogle funktions beskrivelser jeg vist lige skal have gået igennem på Standard FB, da de jo ikke passer med virkeligheden: ØH og ØV tænder ikke begge lys over spisebord.

 

Og fint med flere billeder og grafik visning af "mærkelige" komponenter (ind/ud)

 

[Lars Jacobsen]

Nå fandt ud ud af det Brun vedr. kabel 1 skyldes jeg har et kabel 1 i hovedtavlen og et kabel 1 til min undertavle. Det kan du og dokumentationen jo ikke vide (og kende forskel på) Godt jeg har skrevet det i ID kode feltet.

Hvad med Note/bemærknings feltet. Kan vi få det med ud også ? Evt. som "avanceret tilvalg ?

 

[Mikkel Skovgaard]

Ja det med note har jeg tænkt på længe. Tænker det kan stå under som en fold ud ting.

[Mikkel Skovgaard]

Og lidt mere:

- Noter kommer nu med ud - jeg arbejder på en god måde at vise det - overvejer om at hvis en tanget f.eks. ikke har nogen beskrivelse at man så kunne skrive hvad funktionsblokken den linker med gør men det bliver måske noget rod.

- Næsten alt burde have grafik - LK har så valgt ikke at have unikke produktnumre hele vejen igen (og der er fejl i deres XML definitioner med mere) - gør det svært men jeg har en løsning. Men sig til hvis noget er helt forkert

- Har fjernet oversigten på siden - den er nu kun i menuen som nu også har under sektioner med

- Hurtigere behandling af dokumentet igen

Som altid lad mig høre hvis noget driller - jeg roder med en PDF generator men de fleste browser kan jo gemme som PDF nu om dage så det tror jeg bare jeg dropper igen. Så der er snart ikke mere jeg kan finde på 

[Mikkel Skovgaard]

Og lidt mere:

- Tilføjet funktionsdokumentationen i hovedvisningen - det gav mere mening for mig

- Tilføjet link til LKs pdf forklaringer hvis de findes

- Visning om input/funktionsblok er låst

[Bjarne Sørensen]

Jeg har en ide. 

Det kunne være fedt hvis man inde i Ihc-Captain kan frembringe denne dokumentation. 

 

[Mikkel Skovgaard]

3 minutter siden, Bjarne Sørensen skrev:

Jeg har en ide. 

Det kunne være fedt hvis man inde i Ihc-Captain kan frembringe denne dokumentation. 

 

Tjaa - det er da måske noget om - det burde nu være relativt nemt

[Mikkel Skovgaard]

Går lidt og pønser på om man skulle lave så man kunne ændre i tingene direkte deri også gemme en kop - det er tit jeg bruger værktøjet til at finde fejl og er træt af skal over i LK Visual bare for lige at rette lidt tekst

[Kandersen]

11 timer siden, Mikkel Skovgaard skrev:

Går lidt og pønser på om man skulle lave så man kunne ændre i tingene direkte deri også gemme en kop - det er tit jeg bruger værktøjet til at finde fejl og er træt af skal over i LK Visual bare for lige at rette lidt tekst

Bare hit med det. Har også irriteret mig, plus at det er nemmere at rette noget, der hvor man kan se (overskue) at det mangler. Fx en del kabler jeg mangler endnu 

[Mikkel Skovgaard]

Overvejer stadig om man skulle gå All in og lave LK visual i browseren

[Kandersen]

Det er også en mulighed, men måske lidt mere omstændig. Hvordan vil du klare det med at linke wireless?

[Mikkel Skovgaard]

2 timer siden, Kandersen skrev:

Det er også en mulighed, men måske lidt mere omstændig. Hvordan vil du klare det med at linke wireless?

Hvis det er på IHC captain er det nemt nok. 

Men nu var mest for sjov og udfordringen

[Kandersen]

@Mikkel Skovgaard

IHC projekt dokumentation. Kan du fortælle mig, hvordan den sortere i kablerne? Jeg kan ikke rigtig finde hoved og hale i det. 
Kan det evt laves så den sortere efter Lokalitet? 

[Mikkel Skovgaard]

10 timer siden, Kandersen skrev:

@Mikkel Skovgaard

IHC projekt dokumentation. Kan du fortælle mig, hvordan den sortere i kablerne? Jeg kan ikke rigtig finde hoved og hale i det. 
Kan det evt laves så den sortere efter Lokalitet? 

Kablerne er hvis sorteret efter navn.

[Kandersen]

1 time siden, Mikkel Skovgaard skrev:

Kablerne er hvis sorteret efter navn.

Det troede/håbede jeg også, men ser ikke sådan ud. 
Jeg er (indimellem alt muligt andet) i gang med at opdatere dokumentationen i mit program. Jeg har valgt at kalde kablerne fortløbende numre ud fra lokalitet. 
Dvs første lokalitet vil være 01. Og første kabel vil være 01. Dvs første kabel kommer til at hedde 01.01. Næste kabel samme lokation 01.02. Næste lokation hedder 02, og første kabel igen 01. Så første kabel i 2. lokation vil være 02.01.. osv.  

Men i listen over kabler i IHC dokumentation, der bliver de ikke oplistet på den måde. Noget kunne tyde på, at de er listet efter kabeltype. Men det er ikke i en alfabetisk rækkefølge. Listen tager IHC link 6 kablerne først, derefter et kabel uden bogstav, hvorefter den tager PST kabler. Og til sidst IHC link 10. Det er den eneste umiddelbare "orden" jeg kan se i det. 
Se vedhæftet:

EDIT - Det er i øvrigt også pudsigt, at flere kabler har ingen lysgruppe, selvom det er angivet.. 
 

[Bjarne Sørensen]

Jeg oplever også fejl i sorteringen. Førhen var de sorteret på kabel nummer, super overskueligt.

Nu ser det ud til at de måske er sorteret lidt efter hvilke farve ledere der er brugt.

Det springer noget i numrene.

[mmc]

Hej Mikkel,

Super generator! Så meget bedre end den fra LK.

Feature request: Fedt hvis man kunne få dokumentationen til at vise de interne resource ID'er på inputs og outputs ? (til API udviklere).

Mvh

Morten

[Mikkel Skovgaard]

På 18.3.2019 at 14:01 , mmc skrev:

Hej Mikkel,

Super generator! Så meget bedre end den fra LK.

Feature request: Fedt hvis man kunne få dokumentationen til at vise de interne resource ID'er på inputs og outputs ? (til API udviklere).

Mvh

Morten

Det er kommet nu. Er "gemt" under Avanceret menuen: "Vis interne IDs"

Sammen med lidt ekstra nyt:

• Fuld dokumation af funktionblokke - under avanceret "Vis funktionsblokke"
• Tilføjet en række manglende enheders grafik

[Kandersen]

Det er rimeligt sejt med de interne IDére.. Der er godt nok pludselig mange, som man ikke umiddelbart tror er der 

[Mikkel Skovgaard]

20 timer siden, Kandersen skrev:

Det er rimeligt sejt med de interne IDére.. Der er godt nok pludselig mange, som man ikke umiddelbart tror er der 

Alt har et id, hver eneste dag tag næsten.

Jeg er lige på ferie men fik en god ide så når jeg er hjemme (må ikke have computeren med på ferie :-)) så laver jeg den funktionblok visning om så den istedet viser alle ting og med en forklaring af hvad de er forbundet med. Så har man både den tekniske forbindelse med tavle komponenter øverst også alle de enkelte tryk, dimmers med mere og hvordan de er forbundet. På den måde burde dokumentationen være så fuldstændig som jeg kan lave den uden at lave noget hvor man kan redigere på vis filen... Som jeg måske får tid til snart. Gad nemlig virkelig godt at lave så man kan ændre i tingene hvis f.eks der mangler noget dokumentation på en ting, som så igen har først mine tanker imod at lave et værktøj til at et simpelt program hvor man kan indtaste nogle grundlæggende ting: enhed/kabel type, placering, hvor mange ind/udgange der er også indtaste hvordan det er forbundet. Jeg er forundret over sådan noget ikke kan findes.

[mmc]

On 2/15/2020 at 2:01 PM, Mikkel Skovgaard said:

Det er kommet nu. Er "gemt" under Avanceret menuen: "Vis interne IDs"

Sammen med lidt ekstra nyt:

• Fuld dokumation af funktionblokke - under avanceret "Vis funktionsblokke"
• Tilføjet en række manglende enheders grafik

Super fedt - det er bare så lækkert at se det hele samlet.

Nb. Vedr. grafikken, er der dog et par enkelte steder i docs hvor der mangler assets under visningen i min installation. F.eks.

[mmc]

6 hours ago, Mikkel Skovgaard said:

Jeg er lige på ferie men fik en god ide så når jeg er hjemme (må ikke have computeren med på ferie :-)) så laver jeg den funktionblok visning om så den istedet viser alle ting og med en forklaring af hvad de er forbundet med. Så har man både den tekniske forbindelse med tavle komponenter øverst også alle de enkelte tryk, dimmers med mere og hvordan de er forbundet. På den måde burde dokumentationen være så fuldstændig som jeg kan lave den uden at lave noget hvor man kan redigere på vis filen... 

Lyder virkeligt interessant - spændt på at se noget her :-)

[Kandersen]

6 timer siden, Mikkel Skovgaard skrev:

Alt har et id, hver eneste dag tag næsten.

Ja, det er jo heldigvis ret tydeligt nu. Og jeg tror da også der er en del af dem jeg vil forsøge lege lidt dybere med 

6 timer siden, Mikkel Skovgaard skrev:

Jeg er forundret over sådan noget ikke kan findes.

Jeg tror det hænger sammen med, at dels er der mange forskellige holdninger til dokumentation. Nogle vil gerne have alt, til det mindste komma, mens andre kan "nøjes" med noget overordnet, og stadigvæk bevare overblikket. 

[Mikkel Skovgaard]

30 minutter siden, Kandersen skrev:

Ja, det er jo heldigvis ret tydeligt nu. Og jeg tror da også der er en del af dem jeg vil forsøge lege lidt dybere med 

Jeg tror det hænger sammen med, at dels er der mange forskellige holdninger til dokumentation. Nogle vil gerne have alt, til det mindste komma, mens andre kan "nøjes" med noget overordnet, og stadigvæk bevare overblikket. 

Personligt vil jeg gerne have fuld sporbarhed så jeg kan spore fra tavle til udtag etc

[Mikkel Skovgaard]

42 minutter siden, mmc skrev:

Super fedt - det er bare så lækkert at se det hele samlet.

Nb. Vedr. grafikken, er der dog et par enkelte steder i docs hvor der mangler assets under visningen i min installation. F.eks.

Tror det er løst i den opdatering jeg lavede.

Den viser den fulde URL i udskrift for at man nemmere kan slå op og finde filen men det burde nok være den fulde URL eller bare slet ikke.