webForumDet fria alternativet

Planera projekt

9 svar · 694 visningar · startad av Qimen

QimenMedlem sedan juni 20015 009 inlägg
#1

Hej,

De flesta projekt jag har gjort är åt andra designers som gjort designen (på webben) och jag själva systemet. För det mesta har jag bara skrivit allt rakt upp och ned utan vidare (har lätt för att komma ihåg saker), ibland har jag gjort en lista med olika funktioner/medoder som ska vara med.

Nu har jag dock kommit fram till att det är dags att börja planera projekten mer ordentligt innan jag börjar, dels för att man får bättre återblick när man kollar tillbaka sen och dels för att större projekt blir lite för invecklade för att kunna hållas i huvudet.

o Har ni tips på hur man kan planera ett projekt (huvudmål: webben)?
o Hur gör ni själva?
o Bör man ha en speciell mappstruktur och finns det någon slags standard?
o Bör man använda något speciellt program?
o Hur bör man dokumentera det hela? Ändringslogg?
o Finns det något smart sätt som man kan lagra/rapportera buggar/säkerhetsfixar/patchar på så att man sedan enkelt att kolla vad som hänt innan och vad de innebar?
o Hur bör man kommentera i sina filer? har sett att man ibland har /** bla bla */ och ibland bara /* */. Vad innebär dessa?
o När man kommenterar funktioner/metoder, någon speciell info man bör ha med?

Tack på förhand! :)

Mvh
Qimen

nitro2k01Medlem sedan aug. 20039 342 inlägg
#2

Re: Planera projekt

Qimen skrev:

o Bör man ha en speciell mappstruktur och finns det någon slags standard?

Man bör väl ha bilder, stilmallar och html/php-dokument för sig i varsin katalog.
Om du inte använder PHP (eller ASP) + databaser genom querystrings, så kan det vara en idé att skapa mappar med grupper av html-dokument.
Du bör även tänka på att använda absoluta och relativa sökvägar rätt, t ex i en fil:

[url]http://www.doman.se/info1/html/index.html:[/url]
...
<link rel="stylesheet" href="/globalcss/body.css" />
<a href="dokument1.html">Länk</a>
<img src="../images/bild.gif" />
...

Sen vet jag dock inte om det finns nån "officiell" standard, men det tror jag inte, och det har jag aldrig hört talas om.

Qimen skrev:

o Bör man använda något speciellt program?

Vad du använder för program är upp till dig, men om du arbetar professionellt bör det ha ftp-stöd så du kan kolla på det du skapar online, i sin rätta miljö.(Edit: Om det handlar om html i någon form. Det verkar nästan som att det du håller på med är java från din beskrivning) Själv använder jag mest en texteditor med färgkodning, t ex xk, textpad eller emacs.

Qimen skrev:

o Hur bör man dokumentera det hela? Ändringslogg?

Detta är något jag har varit dålig själv, men det är en bra idé, och du kommer tacka dig själv senare. Och framför allt: Ta säkerhetskopior med jämna mellanrum!

Qimen skrev:

o Finns det något smart sätt som man kan lagra/rapportera buggar/säkerhetsfixar/patchar på så att man sedan enkelt att kolla vad som hänt innan och vad de innebar?

Jag har tyvärr aldrig använt något sådant, även om jag borde, men det finns något som heter CVS som du kan kolla närmare på:
http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1

Qimen skrev:

o Hur bör man kommentera i sina filer? har sett att man ibland har /** bla bla */ och ibland bara /* */. Vad innebär dessa?

// är en enradskommentar i C-liknande språk. /* ... */ är en flerradskommentar. /** */ är också en flerradskommentar, med skillnaden att du i java kan använda verktyget javadoc för att skapa en dokumentation, som då skapas utifrån det som står mellan /** och */.

Qimen skrev:

o När man kommenterar funktioner/metoder, någon speciell info man bör ha med?

Jag brukar ha som regel att skriva kort vad metoden tar för input-data och vad den returnerar. Dessutom brukar jag skriva en förklarande kommentar då jag har använt "ad hoc"-lösningar. (Lösningar som innefattar oväntade tekniker)
Det är bra att ha som påminnelse när man tittar på koden en månad senare och inte förstår vad man själv menade.

LaspMedlem sedan juli 200012 980 inlägg
#3

Tack så mycket nitro2k01 för ditt svar.
Jag tror att vi tar upp lite av detta i kvällens diskussion om UML också.
Vi får nog en hel del att diskutera om. :stud :birp :birp

QimenMedlem sedan juni 20015 009 inlägg
#4

Re: Re: Planera projekt

nitro2k01 skrev:

Qimen skrev:

o Bör man ha en speciell mappstruktur och finns det någon slags standard?

Man bör väl ha bilder, stilmallar och html/php-dokument för sig i varsin katalog.
Om du inte använder PHP (eller ASP) + databaser genom querystrings, så kan det vara en idé att skapa mappar med grupper av html-dokument.
Du bör även tänka på att använda absoluta och relativa sökvägar rätt, t ex i en fil:

[url]http://www.doman.se/info1/html/index.html:[/url]
...
<link rel="stylesheet" href="/globalcss/body.css" />
<a href="dokument1.html">Länk</a>
<img src="../images/bild.gif" />
...

Sen vet jag dock inte om det finns nån "officiell" standard, men det tror jag inte, och det har jag aldrig hört talas om.

Okej. Tror min nurvarande mappstruktur är tillräckligt bra då. Brukar köra med: archive_in/ut (för filer som man laddar in, ex plugins samt om man packar upp de så hamnar de i ut), services (där har jag script som körs som service/cron), source (här har jag alla klasser, "drivrutiner" till olika databaser..), logs (lagrar alla loggar som webbprojektet genererar), html (alla grafik som inte ingår i templatedesignen, dvs smilies, gubbar osb..), tmp (sedan en mapp för varje olika templateval, ex. standard, fotbollstema. Sedan i varje sådan mapp har jag mapparna css, images, flash, javascript, templates (själva tmp-filerna) och template_c (de kompilerade template-filerna)).

Qimen skrev:

o Bör man använda något speciellt program?

Vad du använder för program är upp till dig, men om du arbetar professionellt bör det ha ftp-stöd så du kan kolla på det du skapar online, i sin rätta miljö.(Edit: Om det handlar om html i någon form. Det verkar nästan som att det du håller på med är java från din beskrivning) Själv använder jag mest en texteditor med färgkodning, t ex xk, textpad eller emacs.

Okej, mitt fel. Jag menade något program som man kan hålla reda på allt i, ex. buggar/funktioner man tänkt göra osv. Utveckklingsprogram har jag redan skaffat mig favoriter av (dw, zend, eclipse, textpad).

Qimen skrev:

o Hur bör man dokumentera det hela? Ändringslogg?

Detta är något jag har varit dålig själv, men det är en bra idé, och du kommer tacka dig själv senare. Och framför allt: Ta säkerhetskopior med jämna mellanrum!

Jo säkerhetskopier tar jag regelbundet. Själv lägger jag alltid med ett par textfiler i rooten utanför själva projektet. Filer som Changes (med alla ändringar från version till version), Readme (med lite allmän info om projektet och om det är något speciellt man bör tänka på, en fil med vilka som medverkat i projektet, en fil med information om hur accessnivåer fungerar i systemet osv. Tror det duger bra.

Qimen skrev:

o Finns det något smart sätt som man kan lagra/rapportera buggar/säkerhetsfixar/patchar på så att man sedan enkelt att kolla vad som hänt innan och vad de innebar?

Jag har tyvärr aldrig använt något sådant, även om jag borde, men det finns något som heter CVS som du kan kolla närmare på:
http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1

CVS har man hört talas om rätt mycket men aldrig satt sig in. Det får jag nog ta och titta på. Verkar intressant, finns dessutom en bra introduktion där. :) Men innebär CVS att hela projektet är Open-source?

Qimen skrev:

o Hur bör man kommentera i sina filer? har sett att man ibland har /** bla bla */ och ibland bara /* */. Vad innebär dessa?

// är en enradskommentar i C-liknande språk. /* ... */ är en flerradskommentar. /** */ är också en flerradskommentar, med skillnaden att du i java kan använda verktyget javadoc för att skapa en dokumentation, som då skapas utifrån det som står mellan /** och */.

Ah där ser man. Har alltid trott det varit någon slags standard, vet att i java kan man skapa en smart dokumentation men har även använt /** i mina phpscript.

Qimen skrev:

o När man kommenterar funktioner/metoder, någon speciell info man bör ha med?

Jag brukar ha som regel att skriva kort vad metoden tar för input-data och vad den returnerar. Dessutom brukar jag skriva en förklarande kommentar då jag har använt "ad hoc"-lösningar. (Lösningar som innefattar oväntade tekniker)
Det är bra att ha som påminnelse när man tittar på koden en månad senare och inte förstår vad man själv menade.

Att förklara sin kod tycker jag är viktig så att man kommer ihåg vad man gjort samt om någon annan ska kolla på koden och ev. ändra något så att de förstår. Brukar man skriva något speciellt om inputvariabler osv? Har sett i en hel del script där man använder param. :)

Tack för svaren nitro2k01!
Lasp: Jadu, det blir nog inte tyst iaf. :e

QimenMedlem sedan juni 20015 009 inlägg
#5

Only Open Source projects may be hosted on SourceForge.net.

Det var ju lite synd. Tror inte det är så bra att ha detta projekt (som jag arbetar med nu) på Sourceforge. Kan man inte använda cvs på något annat sätt eller finns det någon annan sida som är som Sourceforge fast där man kan ha sluten källkod? :)

spangoMedlem sedan juni 20008 205 inlägg
#6

Qimen skrev:

Only Open Source projects may be hosted on SourceForge.net.

Det var ju lite synd. Tror inte det är så bra att ha detta projekt (som jag arbetar med nu) på Sourceforge. Kan man inte använda cvs på något annat sätt eller finns det någon annan sida som är som Sourceforge fast där man kan ha sluten källkod? :)

CVS är bara ett versionshanteringssystem, det går alldeles utmärkt att använda till icke-open source. Du kan slänga upp en *NIX server med SSH och CVS installerat, så kan du checka ut ett projekt från i princip vilken burk som helst. Gå till https://www.cvshome.org/ för mer information, en bra början är "Cederqvistaren" (ligger nånstans under dokumentationssidorna).

\r Efter att ha läst de tidigare inläggen lite närmare, kan jag passa på att påpeka att CVS inte är ett buggrapporteringssystem, även om ett versionshanteringssystem håller koll på vilka förändringar man gör, låter en logga dem etc. Buggrapporteringssystem finns det en bunt, ett är Bugzilla.

\r2 Vad gäller allt annat, kan jag bara säga att hur man gör beror på hur man gör det ;)
Alla har sina egna tillvägagångssätt, men de är alla till för att underlätta för utvecklarna. Den enda generella regeln jag vill säga är att "versionshantera allt", förutom sånt som genereras av en kompilator. Versionshantering är helt enkelt Rätt och Bra.

QimenMedlem sedan juni 20015 009 inlägg
#7

Vi diskutera detta en del på vår UML/wF-träff igår. Naturligtvis får man kombinera CVS med ex. bugzilla. Jag har kollat en del på bugzilla men har inte fått det fungera riktigt ordentligt så får väl sätta mig ned och försöka igen. :)

WalkerMedlem sedan okt. 2002188 inlägg
#8

Hej

Letade efter ett bra bugghanteringsystem för ett tag sedan. Buggzilla verkar trevligt men jag orkade inte installera det, utan hittade http://www.mantisbt.org/ istället och det fungerar faktiskt ganska bra. Det finns en webbtjänst som man kan installera som flaggar när det kommer in en ny bugg. Var väldigt lätt att installera å lätt att komma igång med. rekommenderas

LaspMedlem sedan juli 200012 980 inlägg
#9

Mycket bra Walker. Ser fram emot en demo vid nästa träff IRL.

WalkerMedlem sedan okt. 2002188 inlägg
#10

hehe.. visst :)

Men då måste jag veta när nästa träff är. Har inte settt något nytt datum.

Lasp, kanon att du har tagit tag i detta. Har iofs inte varit med på något möte än men det känns verkligen spännande.

149 ms totalt · 3 externa anrop · v20260731065814-full.30151723
0 ms — hämta forumlista (cache)
0 ms — hämta statistik (cache)
146 ms — hämta tråd, inlägg och bilagor (db)