Vi använder sphinx med plantuml för dokumentation av design.
Eclipse har plugins för att generera plantuml-graferna direkt och man kan koncentrera sig på det logiska istället.
Sedan är det bara att inkludera sin graf i något dokument i sphinx.
-- /Mvh Kenneth Andersson System and software design Realtime Embedded AB Sveavägen 64, 111 34 Stockholm, Sweden http://www.rte.se ________________________________________ Från: foss-sthlm [foss-sthlm-bounces_at_cool.haxx.se] för bengt bäverman [bengt_at_baverman.se] Skickat: den 24 februari 2014 13:15 Till: FOSS-folk i Stockholm Ämne: Re: Grafiskt stödverktyg för mjukvaruutveckling Magnus m fl, apropå whiteboard och kamera tycker jag att det fungerar väldigt bra tillsammans med en projektor. Man visar föra "mötets" bild på whiteboarden med projektorn. Sen går man lös på tavlan med pennor och gula lappar. Det avslutas med fotografering av den nya tavlan (tillsammans med projektorbilden om man vill). Repetera! Funkar bra om man skall tänka tillsammans -- kanske mindre bra om man skall tänka själv. Då använder jag oftast penna och papper. Jag tänker oftast bättre med penna i handen än ett ritprogram. När jag använder strukturerade program på datorn så tänker jag ofta för mycket på strukturen och formen, snarare än innehållet. Om jag skall skriva text använder jag därför gärna Emacs och M-Q för att automatisk justera texten. Det blir som det blir och jag koncentrerar mig mer på innehållet. Skulle jag använda någon ordbehandlare skulle jag tänka mer på fontval, rubrikstorlek och annat icke-produktivt. Enklast tänkbara verktyg fungerar bäst för mig, så att jag kan koncentrera mig på innehållet. /B Den 24 februari 2014 11:52 skrev Magnus Sandberg <mem_at_netnod.se<mailto:mem_at_netnod.se>>: 2014-02-24 11:09, Per Andersson skrev: > 2014-02-24 10:48 GMT+01:00 Magnus Sandberg <mem_at_netnod.se<mailto:mem_at_netnod.se>>: >> Hej! >> >> Jag letar efter något bra verktyg för att underlätta när man ska >> utveckla ett program. Jag vet inte om frågan diskuterats tidigare. >> >> >> Papper och penna blir för statiskt och inte så miljövänligt eller >> portabelt som en fil i sin laptop. Den grundläggande tanken behöver >> struktureras om efter ett par tankeiterationer och då blir ett papper >> bara kladdigt. Att börja om på ett nytt papper skapar onödigt >> dubbelarbete. Klipp och klistra skulle förstås vara en variant men jag >> vet inte om lim och tejp är rätt väg. >> >> Mindmaps känns som fel sorts verktyg. >> >> Inkscape skulle kunna vara ett bra verktyg men tycker att det är för >> buggigt (åtminstone de Linux-versioner jag kört). På jobbet har vi vissa >> systemritningar i SVG och jag har gått över till att underhålla dem i >> Emacs... Men då handlar det om att underhålla eller duplicera >> existerande SVG:er, inte att bygga från noll. >> >> Det som känns minst fel för tillfället är LibreOffice Draw men det känns >> inte helt rätt heller. Draw har jag använt till husritningar hemma och >> är hyfsat nöjd. Draw fungerar nog bra för att visualisera ett färdigt >> system, inte att utveckla det. >> >> >> Mitt behov handlar inte projektmodellering eller att automatiskt omsätta >> den grafiska designen till kod. Det handlar mer om ett sätt att slippa >> konstruera med gula minneslappar eller klipp och klistra. >> >> Det är mer av - "Nu ska jag skapa ett program/skript som ska lösa Foo". >> I första tankevändan inser jag att det behövs variablerna X och Y. Sedan >> bryter jag ner problemet Foo ett antal delfunktioner. Så inser jag att >> någon delfunktion behöver en ny variabel och att man kan bryta loss viss >> logik i ett fristående program eller som ett funktionsanrop osv. >> >> Så tankesättet är ganska mindmaps-likt men det är inte mindmaps i layout:en. >> >> >> Det är även bra om resultatet går att använda som en del i >> system/funktionsdokumentationen. Eftersom jag nu saknar "visuell" >> designdokumentation så blir startsträckan ganska lång när man behöver >> göra ändringar 2 år senare eller så. Att börjar med att analysera >> befintlig kod/skript-logik (för att minnet är kortare än 2 år) innan man >> kan designa ändringarna är inte optimalt. > > Jag såg att du inte tyckte att papper och penna var något bra. Varför? > Det är det jag själv använder när jag behöver visualisera mina tankar. > Alternativt whiteboard tillsammans med andra. (Tycker att det funkar bra > från att tänka ut hur något litet shell script ska fungera till att bevisa en > algoritm.) > > När det är någorlunda färdigtänkt och attackerat plitar jag ner det som > grafer med ASCII, för dokumentation. > > Du säger att det inte är likt mindmaps, jag tycker att det låter > väldigt mindmap. > Det är ju bara en graf, vilket väl är det du vill skapa? Har du testat Dia eller > graphviz? > > Vidare jobbar jag själv testdrivet i största möjliga mån, som Johan beskriver. > I början är det whiteboardingsessioner som gäller för att få någon slags plan > ur allt tankekaos och alla idéer. Jag svarar till er alla tre då det är väldigt likartade svar jag fått. Whiteboard hade varit kul. Tyvärr sitter jag i ett öppet landskap där möbleringen av min arbetsplats in ger någon plats till egen whiteboard. Jag höll på att få eget kontorsrum men blev snuvad framför näsan då en annan avdelning anställde en person med högre befattning... I och för sig finns det whiteboards i bordsmodell eller på blädderblocksstativ. Konferensrum fungerar bra vid brainstorming men inte om man vill kluddra vidare under arbetets gång. Dia är nog det jag ska titta på. Graphviz känns inte lika rätt just för det jag vill lösa just nu. Jag försökte mig på Dia (och Xfig) för typ 10+ år sedan och då var det rena misären, huggmejsel och stentavla kändes som mer anpassningsbara då. Tack för era tips och reflektioner! // Mem _______________________________________________ http://www.foss-sthlm.se/ http://cool.haxx.se/cgi-bin/mailman/listinfo/foss-sthlm _______________________________________________ http://www.foss-sthlm.se/ http://cool.haxx.se/cgi-bin/mailman/listinfo/foss-sthlmReceived on 2014-02-24