Documentatie in imagini
Documentatie in imagini
Astazi vreau sa vorbesc un pic despre defectele mele ca programator.
16 May 2017
2162
Other articles
Object-relational Mapping folosind JPA, Hibernate si Spring Data JPA. Persistence cu JPA
Cum sa interogam Kafka Streaming Data?
Procrastinarea. Care sunt avantajele ei?
Object-relational Mapping folosind JPA, Hibernate si Spring Data JPA
Procrastinarea
Cerinte. De ce avem nevoie de ele?
Dezvolta-ti abilitatile cu training-urile noastre
Programarea reactiva Java. Implementari
Testarea software. Intrebari tipice si raspunsuri. Continuare
Testarea software. Intrebari tipice si raspunsuri
Astazi vreau sa vorbesc un pic despre defectele mele ca programator.
Sunt un programator usor lenes.
Nu imi place sa petrec timp facand debugging extensiv.
Nu imi place sa dezvolt tot felul de hack-uri pentru integrare. Sunt prea lenes sa dezvolt solutii temporare pentru ca oricum se va reveni asupra lor mai tarziu. Nu imi place sa petrec timp explicand arhitectura unei componente din sistem developerilor care lucreaza pe platforme diferite.
Sunt o persoana vizuala dar nu pot sa desenez foarte bine.
Imi este mai usor sa inteleg informatia atunci cand este prezentata in imagini in loc sa citesc pagini peste pagini de text. Nu sunt foarte bun la desen si nu prea am chef sa imi instalez programe sofisticate.
Uneori sunt retrograd.
Imi plac lucrurile mai vechi dar care si-au demonstrat valoarea in timp. Imi place ca programele pe care le folosesc sa fie precise deoarece sunt prea lenes sa rezolv incertitudinile. Si imi place si cand schimbarile in documentatie sunt usor de urmarit.
Astfel pe baza experientei mele profesionale si a trasaturilor mele am ajuns la concluzia ca cea mai buna metoda de a dezvolta documentatia si de a o distribui developerilor, project/product managerilor si echipei de QA este prin intermediul unor resurse grafice.
Solutie.
Cautand pe Internet o solutie la provocarea mea m-au ajutat destul de mult Graphviz si DOT. Folosind limbajul DOT puteti sa descrieti cu usurinta diagrame si grafice care sa reprezinte arhitectura unor componente similare pentru web, iOs si Android si apoi sa exportati in ce format doriti – png/svg/jpeg. Sunt foarte multe pluginuri pentru DOT: pentru IDE sau pentru servicii web precum Confluence. Si asta inseamna ca poti sa vizualizezi un document nu doar din linia de comanda ci si din interiorul aplicatiilor standard.
In afara de asta DOT este foarte bun pentru a descrie FSM (finite state machines). Si bineinteles din moment ce DOT este un limbaj, orice schimbari dintr-un fisier text ce contine o descriere a componentei cu orice version of control va fi reparat automat.
Mai jos este ce putem face cu DOT si Graphiz.
Si iata si reprezentarea textuala:
Mai mult imi place faptul ca ma pot concentra pe continut si nu pe reprezentare – toate elementele vor fi desenate si vor fi aranjate automat si nu va trebui sa rearanjati blocurile dupa ce faceti schimbari.
Ivan Alyakskin
Software Consultant
Sunt un programator usor lenes.
Nu imi place sa petrec timp facand debugging extensiv.
Nu imi place sa dezvolt tot felul de hack-uri pentru integrare. Sunt prea lenes sa dezvolt solutii temporare pentru ca oricum se va reveni asupra lor mai tarziu. Nu imi place sa petrec timp explicand arhitectura unei componente din sistem developerilor care lucreaza pe platforme diferite.
Sunt o persoana vizuala dar nu pot sa desenez foarte bine.
Imi este mai usor sa inteleg informatia atunci cand este prezentata in imagini in loc sa citesc pagini peste pagini de text. Nu sunt foarte bun la desen si nu prea am chef sa imi instalez programe sofisticate.
Uneori sunt retrograd.
Imi plac lucrurile mai vechi dar care si-au demonstrat valoarea in timp. Imi place ca programele pe care le folosesc sa fie precise deoarece sunt prea lenes sa rezolv incertitudinile. Si imi place si cand schimbarile in documentatie sunt usor de urmarit.
Astfel pe baza experientei mele profesionale si a trasaturilor mele am ajuns la concluzia ca cea mai buna metoda de a dezvolta documentatia si de a o distribui developerilor, project/product managerilor si echipei de QA este prin intermediul unor resurse grafice.
Solutie.
Cautand pe Internet o solutie la provocarea mea m-au ajutat destul de mult Graphviz si DOT. Folosind limbajul DOT puteti sa descrieti cu usurinta diagrame si grafice care sa reprezinte arhitectura unor componente similare pentru web, iOs si Android si apoi sa exportati in ce format doriti – png/svg/jpeg. Sunt foarte multe pluginuri pentru DOT: pentru IDE sau pentru servicii web precum Confluence. Si asta inseamna ca poti sa vizualizezi un document nu doar din linia de comanda ci si din interiorul aplicatiilor standard.
In afara de asta DOT este foarte bun pentru a descrie FSM (finite state machines). Si bineinteles din moment ce DOT este un limbaj, orice schimbari dintr-un fisier text ce contine o descriere a componentei cu orice version of control va fi reparat automat.
Mai jos este ce putem face cu DOT si Graphiz.
Si iata si reprezentarea textuala:
Mai mult imi place faptul ca ma pot concentra pe continut si nu pe reprezentare – toate elementele vor fi desenate si vor fi aranjate automat si nu va trebui sa rearanjati blocurile dupa ce faceti schimbari.
Ivan Alyakskin
Software Consultant