Zorg API Doku

2
Bug #
Priorität4 (▼ Niedrig)
BereichCode
TitleZorg API Doku
BeschreibungIn der Zorg API Doku sollte erwähnt werden, dass in Funktionen für DB- und User-Funktionen die entsprechenden Globalen Variablen geholt werden müssen:

global $db, $user;

Sonst geht nix.

Zudem sollte ein Standart für die Funktionen-Beschreibung definiert werden, vorzüglich im PHPDocu-Stil. Bsp.:

/**
* Meine Klasse
*
* @author IneX
* @date 23.05.2009
* @version 1.0
* @desc Kurz-Beschreibung meiner läässen Klasse
* @package Zorg
* @subpackage Meine Klasse
*
* Lange Beschreibung meiner tollen
* Funktion. Hier kann ich auf mehreren
* Zeilen schreiben, was ich will.
* Natürlich müssen nicht alle Parameter
* für die Doku verwendet werden.
*/
class MeineKlasse
{

/**
* Meine Funktion
* @author IneX
* @version 1.0
* @since 1.0 (Version der Klasse)
* @desc Kurz-Beschreibung meiner Funktion
* @package Zorg
* @subpackage Meine Klasse
*
* @return string
* @param $user_id User-ID
*/
function MeineFunktion($user_id)
{
global $db, $user; // Für DB Operationen & User Variablen
// Code...
}

}
Reported by @
 
Git Commit
Assigned to @ 19.05.2009 17:30
StatusResolved @ 2
zorg.ch
#109729 by @ 26.05.2009 19:55 - nach oben -
Die Dokumentation sollte dem PHPDocu Standard gerecht werden.
zorg.ch
#114279 by @ 04.01.2016 16:57, edited @ 04.01.2016 17:02 - nach oben -
Wurde in der Anleitung/Readme zum Zorg Code als neuer Punkt "Dokumentation" ergänzt (Commit #b81f6ea):

Zorg Repo - Readme