[1.16] Code-Dokumentation

Dieser Bereich dient dazu, neue Features zu diskutieren und für die Entwicklung zu dokumentieren. // This area is dedicated to new features including proposals and documentation.
Benutzeravatar
dr.e.
Administrator
Beiträge: 4555
Registriert: 04.11.2007, 16:13:53

[1.16] Code-Dokumentation

Beitrag von dr.e. » 18.10.2012, 22:45:14

Hallo zusammen,

ich habe eine Bitte an alle Contributoren für 1.16: bitte prüft eure Checkins nach deutschen Kommentaren. Mir sind bei einem Code-Inspection-Lauf in PHPStorm einige Stellen aufgefallen. Danke euch! :)
Viele Grüße,
Christian

Megger
Beiträge: 1233
Registriert: 04.11.2008, 10:57:37

Re: [1.16] Code-Dokumentation

Beitrag von Megger » 18.10.2012, 22:54:18

Muss unbedingt mal 1.16 auschecken und ausprobieren! Bin momentan zeitlich leider sehr eingebunden und komme kaum noch dazu mich mit dem APF zu beschäftigen, ich hoffe, dass wird wieder besser!

Ich hoffe ich habe alles dokumentiert, wenn ich irgendwas zu 1.16 beigetragen habe :D

Aber ich check nochmal den Quellcode
Tutorial: Browsergame mit dem APF (Die ersten Parts handeln von Installation und Inbetriebnahme des APFs, deswegen sicherlich auch für alle Nicht-Browsergame-Programmierer interessant)

APF-Version
  • Entwicklung: 2.0
  • Produktiv: 1.15

Benutzeravatar
dr.e.
Administrator
Beiträge: 4555
Registriert: 04.11.2007, 16:13:53

Re: [1.16] Code-Dokumentation

Beitrag von dr.e. » 18.10.2012, 22:58:29

Super, danke!

PS: Schon für die APF-DEV-CON gevotet?
Viele Grüße,
Christian

jprangenberg
Beiträge: 410
Registriert: 16.08.2010, 22:14:54

Re: [1.16] Code-Dokumentation

Beitrag von jprangenberg » 19.10.2012, 00:02:37

Meinst du deutsche Kommentare in den Checkins, oder deutsche Quellcode Dokumentation? :oops:
dr.e. hat geschrieben:PS: Schon für die APF-DEV-CON gevotet?
Ja! 8-)

Benutzeravatar
dr.e.
Administrator
Beiträge: 4555
Registriert: 04.11.2007, 16:13:53

Re: [1.16] Code-Dokumentation

Beitrag von dr.e. » 19.10.2012, 00:19:49

Meinst du deutsche Kommentare in den Checkins, oder deutsche Quellcode Dokumentation? :oops:
Beides... ;)
Viele Grüße,
Christian

Benutzeravatar
dave
Beiträge: 903
Registriert: 04.02.2011, 19:03:57
Wohnort: Berlin
Kontaktdaten:

Re: [1.16] Code-Dokumentation

Beitrag von dave » 19.10.2012, 12:31:43

Wow, habe mir gerade mal deine Änderungen angesehen ... man man man, da habe ich aber einige Fehler rein gehauen. Aber das mit dem englichens sCheme wusste ich gar nicht :roll:

In Zukunft werde ich darauf besser achten!

Benutzeravatar
dr.e.
Administrator
Beiträge: 4555
Registriert: 04.11.2007, 16:13:53

Re: [1.16] Code-Dokumentation

Beitrag von dr.e. » 19.10.2012, 13:30:51

Hallo dave,

kein Stress deswegen. Wenn du PHPStorm nutzt, kannst du dir mal den Code-Inspector ansehen. Dieser hilft dir (und übrigens auch mir) vor dem Checkin nochmals alles zu prüfen. Manche Dinge versteht er nicht ganz und bei deutschen Texten kannst du die Hinweise getrost vergessen, bei vielen anderen Dingen ist er aber sehr hilfreich.

Solltest du noch keine Lizenz haben: viewtopic.php?f=7&t=719
Viele Grüße,
Christian

Benutzeravatar
dave
Beiträge: 903
Registriert: 04.02.2011, 19:03:57
Wohnort: Berlin
Kontaktdaten:

Re: [1.16] Code-Dokumentation

Beitrag von dave » 19.10.2012, 13:40:55

Die Lizenz für PHPStorm kann ich leider nicht einsetzen, da ich ja für ein kommerzielles Projekt entwickle :?

Andererseits könnte ich PHPStorm lediglich für die Arbeit am APF selbst einsetzen. Meinst du, da spricht was dagegen?

jprangenberg
Beiträge: 410
Registriert: 16.08.2010, 22:14:54

Re: [1.16] Code-Dokumentation

Beitrag von jprangenberg » 19.10.2012, 18:07:26

dave hat geschrieben:Die Lizenz für PHPStorm kann ich leider nicht einsetzen, da ich ja für ein kommerzielles Projekt entwickle..
Eine Einzelplatz-Lizenz kostet 90€! Habe diese mir auch vor ein paar Tagen gekauft. Ist nur zu empfehlen! ;-)

Benutzeravatar
dr.e.
Administrator
Beiträge: 4555
Registriert: 04.11.2007, 16:13:53

Re: [1.16] Code-Dokumentation

Beitrag von dr.e. » 19.10.2012, 21:29:57

Hallo dave,
Andererseits könnte ich PHPStorm lediglich für die Arbeit am APF selbst einsetzen. Meinst du, da spricht was dagegen?
Das ist gemäß Lizenz-Vereinbarung mit JetBrains möglich.
Viele Grüße,
Christian

Benutzeravatar
jwlighting
Beiträge: 466
Registriert: 14.07.2010, 14:23:58
Wohnort: LK Oldenburg
Kontaktdaten:

Re: [1.16] Code-Dokumentation

Beitrag von jwlighting » 20.10.2012, 10:27:46

Hallo,

soweit ich mich erinnern kann, habe ich alle Kommentare in englisch verfasst - das mache ich schon lange so.
Über die sprachliche Richtigkeit meiner Kommentare könnte man allerdings streiten - mein Englisch ist lange nicht perfekt. Ihren Zweck werden sie aber erfüllen ;)

LG :)
Jan

Menschen irren - Politiker sind Menschen.
Für den Norddeutschen ist 1kW = 2 Pfund Schlick.

Benutzeravatar
dave
Beiträge: 903
Registriert: 04.02.2011, 19:03:57
Wohnort: Berlin
Kontaktdaten:

Re: [1.16] Code-Dokumentation

Beitrag von dave » 20.10.2012, 13:06:36

Ha, mir gehts doch genauso und meine englisch sprachigen Dokus für die offizielle Doku erst ... aber man kann eben damit arbeiten, besser als gar nichts :)

Benutzeravatar
dr.e.
Administrator
Beiträge: 4555
Registriert: 04.11.2007, 16:13:53

Re: [1.16] Code-Dokumentation

Beitrag von dr.e. » 20.10.2012, 20:04:59

Jungs macht euch keinen Kopf und lasst euch vor Allem nicht abschrecken, wenn ich Dinge korrigiere. Nutzt diese Punkte einfach als Hinweis für Verbesserungen an der ein oder anderen Stelle. Wenn es Fragen gibt oder ich beim Korrekturlesen helfen soll, einfacj kurz anklopfen (PN, Skype, ...). Einverstanden? :)
Viele Grüße,
Christian

Benutzeravatar
dr.e.
Administrator
Beiträge: 4555
Registriert: 04.11.2007, 16:13:53

Re: [1.16] Code-Dokumentation

Beitrag von dr.e. » 30.10.2012, 00:18:17

Hallo zusammen,

ich bin gerade dabei die Release-Dokumentation für 1.16 zu erstellen. Folgende Bitten haben ich an euch, damit wir das Release wie besprochen im November herausgeben können:

@Lutz: ich habe beim durchsehen der Features für 1.16 gesehen, dass GenericDomainObject::getRelationCreationTimestamp() und GenericDomainObject::extractRelationTimestamps() noch nicht in der offiziellen Dokumentation auftauchen. Kannst du hierzu noch einen Hinweis/eine Erläuterung aufnehmen? Danke!

@Coach: für das Permanent Log-in Feature ist die Doku ebenfalls noch offen. Magst du diese in http://adventure-php-framework.org/Seit ... Verwaltung Doku integrieren? Auch sinnvoll finde ich eine Erweiterung der Beschreibung in der Sandbox. Diese kann ich gerne übernehmen.

@Jan: für den neuen Service-Typ und das geänderte Verhalten des DIServiceManager sollten wir die Doku unter http://adventure-php-framework.org/Seite/107-Services noch etwas erweitern. Kümmerst du dich darum?

Vielen Dank an dieser Stelle nochmals für eure Arbeit an der Version 1.16. Mir hat es gestern und heute sehr viel Spass gemacht zu sehen, dass das APF in der Version 1.16 an sehr vielen Stellen eine deutliche Weiterentwicklung erfahren hat. :)
Viele Grüße,
Christian

Coach83
Beiträge: 271
Registriert: 13.05.2010, 17:33:12
Kontaktdaten:

Re: [1.16] Code-Dokumentation

Beitrag von Coach83 » 30.10.2012, 07:39:57

Moin,

ich würde das gerne übernehmen, komme allerdings frühestens Mitte November dazu. Hab eine mehrwöchige Schulung und muss da jeden Abend noch etliche Themen vor-/ nachbereiten. Hab einfach keine Zeit :?

Gesperrt

Wer ist online?

Mitglieder in diesem Forum: 0 Mitglieder und 3 Gäste