Codestijl - Revision history

Timb at 18:40, 29 April 2018

2018-04-29T18:40:43Z

2018-02-11T19:37:15Z

2018-01-14T16:52:45Z

Iets duidelijker verwoorden

2017-12-10T14:53:23Z

2017-12-10T14:45:58Z

2017-12-04T22:48:39Z

2017-12-04T22:09:31Z

Regel over witruimte na een blok

2017-12-04T21:52:15Z

Opmerking over stijl fixen

2017-12-04T21:50:17Z

Opmerking over is_null()

2017-12-04T21:49:15Z

Meer code tags == meer beter

@@ Line 1: / Line 1: @@
 Omdat we nog genoeg fietsenstallingen hebben, hebben we hier een korte opsomming van wat we mooie stijl vinden.
 * Indentatie is een tab, en doorgaan van regels is twee tabs.
@@ Line 5: / Line 7: @@
 * Na een blok (functiedefinities, <code>if</code>, <code>foreach</code> etc.) komt precies één witregel.
 * Openingshaakjes van blokken zijn verplicht en komen op de regel eronder. (Dus <code>→ if (...)\n→ {\n→ → ...</code>)
 * Klassen zijn UpperCamelCase en functies, variabelen enzo zijn lowerCamelCase.
 * Heb je een afkorting zoals CSV, dan doen we CamelCase nog steeds met hoofdletters: <code>CSVPagina</code>, niet <code>CsvPagina</code>.
 * Code is Nederlandstalig, dus gebruik Nederlandse woorden. Ga hierin ook weer niet te ver: <code>BlaView::tabel()</code> ipv <code>BlaView::table()</code> maar <code>BlaView</code> ipv <code>BlaBlik</code>.
 * Doxygen-commando's zijn met @: <code>@brief</code>, <code>@param</code> bla, <code>@returns</code>, enz.
 * De <code>HTMLPage</code> maak je aan in de controller, de view returnt <code>HTMLObject</code>en die je erin kan stoppen.
 * Als je wilt je checken of iets <code>NULL</code> is, gebruik dan altijd <code>is_null()</code>.

@@ Line 13: / Line 13: @@
 * Gebruik [[Responses]] ipv stateful functies.
 * Gebruik <code>new $blaPage()</code> ipv <code>Page::getInstance('$bla')</code>
 Vul je andere favoriete pet peeves hier in!

@@ Line 16: / Line 16: @@
 Vul je andere favoriete pet peeves hier in!
-Als je iets in code verandert die zich niet helemaal houdt aan deze stijl, fix dat dan (minstens in de methode waar het om gaat).
+Als je met (bestaande) code bezig bent die zich niet helemaal houdt aan deze stijl, fix dat dan (minstens in de methode waar het om gaat).
 [[Category:WebCie]]

@@ Line 4: / Line 4: @@
 * Regels langer dan 80 karakters zijn lelijk maar niet verboden. Dus, wees niet bang om statements en expressies over meerdere regels te verdelen.
 * Na een blok (functiedefinities, <code>if</code>, <code>foreach</code> etc.) komt precies één witregel.
 * Klassen zijn UpperCamelCase en functies, variabelen enzo zijn lowerCamelCase.
 * Heb je een afkorting zoals CSV, dan doen we CamelCase nog steeds met hoofdletters: <code>CSVPagina</code>, niet <code>CsvPagina</code>.

@@ Line 6: / Line 6: @@
 * Klassen zijn UpperCamelCase en functies, variabelen enzo zijn lowerCamelCase.
 * Heb je een afkorting zoals CSV, dan doen we CamelCase nog steeds met hoofdletters: <code>CSVPagina</code>, niet <code>CsvPagina</code>.
 * Doxygen-commando's zijn met @: <code>@brief</code>, <code>@param</code> bla, <code>@returns</code>, enz.
 * De <code>HTMLPage</code> maak je aan in de controller, de view returnt <code>HTMLObject</code>en die je erin kan stoppen.

← Older revision		Revision as of 21:52, 4 December 2017
Line 10:		Line 10:

	Vul je andere favoriete pet peeves hier in!		Vul je andere favoriete pet peeves hier in!
		+
		+	Als je iets in code verandert die zich niet helemaal houdt aan deze stijl, fix dat dan (minstens in de methode waar het om gaat).

	[[Category:WebCie]]		[[Category:WebCie]]