DIG Digital Corner
Alles wat je altijd al over computers, hardware, software, internet en elektronische gadgets had willen weten, maar niet op Tweakers.net durft te vragen.
Inderdaad, vaak ben je beter af met het te herschrijven.quote:Op woensdag 30 juli 2014 21:20 schreef slacker_nl het volgende:
[..]
Ik denk dat je veel meer crap tegenkomt en dat je een hoop can of worms opent. Voel je verder vrij, volgens mij kan je er wel leuk je centen mee verdienen als je lichtelijk sadomasochistisch bent.
Als je je echt alleen concentreert op het vervangen van de mysql_-functies en verder alles laat zoals het is en er ook niet naar kijkt, is het volgens mij best te doen, hoor.
maar als programmeur zijnde kom je vaak zulke slechte code tegen wat je niet zo kunt laten.quote:Op woensdag 30 juli 2014 22:17 schreef Tijn het volgende:
Als je je echt alleen concentreert op het vervangen van de mysql_-functies en verder alles laat zoals het is en er ook niet naar kijkt, is het volgens mij best te doen, hoor.
Doet pijn aan je ogen.
Laatst gewerkt met zo'n lutser van een freelancer. Die gast had 6 maanden zonder enig toezicht code kunnen kloppen. Toen hij wegging maakte hij nog wel even wat opmerkingen over onze code, dat we te weinig design patterns gebruikten enzo.quote:
[..]
maar als programmeur zijnde kom je vaak zulke slechte code tegen wat je niet zo kunt laten.
Doet pijn aan je ogen.
Dus we keken naar z'n code, maar die had echt letterlijk alles herbruikbaar gemaakt. Dus ergens een string die via vijf of zes proxy classes ergens alsnog in de config wordt uitgelezen, ben je dus makkelijk een kwartier aan het zoeken voor een statische waarde. Wtf. Uiteindelijk drie maanden zitten refactoren.
Op dinsdag 9 augustus 2011 23:01 schreef SuperrrTuxxx het volgende:
Ik hou zoveel van jou, ik doe alles voor je! O+
Ik hou zoveel van jou, ik doe alles voor je! O+
Daarom heb je een duidelijke directory structuur nodigquote:
[..]
Laatst gewerkt met zo'n lutser van een freelancer. Die gast had 6 maanden zonder enig toezicht code kunnen kloppen. Toen hij wegging maakte hij nog wel even wat opmerkingen over onze code, dat we te weinig design patterns gebruikten enzo.
Dus we keken naar z'n code, maar die had echt letterlijk alles herbruikbaar gemaakt. Dus ergens een string die via vijf of zes proxy classes ergens alsnog in de config wordt uitgelezen, ben je dus makkelijk een kwartier aan het zoeken voor een statische waarde. Wtf. Uiteindelijk drie maanden zitten refactoren.
Dan heb je geen issues met dingen vinden xD
Oh ja, dat deed hij ook niet nee. Maar dat is zo fijn aan MVC, dat alles convention based is en je dus wel moet houden aan die structuren.quote:
[..]
Daarom heb je een duidelijke directory structuur nodig
Op dinsdag 9 augustus 2011 23:01 schreef SuperrrTuxxx het volgende:
Ik hou zoveel van jou, ik doe alles voor je! O+
Ik hou zoveel van jou, ik doe alles voor je! O+
Ja idd, ik ben ook een type die alles herbruikbaar maakt.quote:
[..]
Oh ja, dat deed hij ook niet nee. Maar dat is zo fijn aan MVC, dat alles convention based is en je dus wel moet houden aan die structuren.
Maar ik zorg er dan wel voor dat het ook makkelijk kan.
Maarja als je zelf iets maakt heb je altijd een beter idee van hoe iets werkt.
Daar ging het imho al mis.quote:
[..]
Laatst gewerkt met zo'n lutser van een freelancer. Die gast had 6 maanden zonder enig toezicht code kunnen kloppen.
Dat denk ik ook.quote:
Als je je echt alleen concentreert op het vervangen van de mysql_-functies en verder alles laat zoals het is en er ook niet naar kijkt, is het volgens mij best te doen, hoor.
quote:
[..]
Laatst gewerkt met zo'n lutser van een freelancer. Die gast had 6 maanden zonder enig toezicht code kunnen kloppen. Toen hij wegging maakte hij nog wel even wat opmerkingen over onze code, dat we te weinig design patterns gebruikten enzo.
Dus we keken naar z'n code, maar die had echt letterlijk alles herbruikbaar gemaakt. Dus ergens een string die via vijf of zes proxy classes ergens alsnog in de config wordt uitgelezen, ben je dus makkelijk een kwartier aan het zoeken voor een statische waarde. Wtf. Uiteindelijk drie maanden zitten refactoren.
Ik zie het al helemaal voor me. Die probeert geforceerd alle design patterns die hij kent zo'n beetje uit overal, ook waar het niet nodig is.
Dat is inderdaad goed. Sowieso een beetje documentatie kan nooit kwaad.quote:
[..]
Ja idd, ik ben ook een type die alles herbruikbaar maakt.
Maar ik zorg er dan wel voor dat het ook makkelijk kan.
Maarja als je zelf iets maakt heb je altijd een beter idee van hoe iets werkt.
Voor bijvoorbeeld een API gebruik ik ApiGen.
Ook al eens naar phpDocumentor gekeken? Die wordt nog actief ontwikkeld.quote:Op woensdag 30 juli 2014 22:52 schreef robin007bond het volgende:
Voor bijvoorbeeld een API gebruik ik ApiGen.
Dat 'moeten' is lang niet altijd zo. Vaak genoeg dikke functies gezien in models, db-interacties in views en halve templates in controllers of zelfs hele sql-schema-declaraties in helpers.quote:
[..]
Oh ja, dat deed hij ook niet nee. Maar dat is zo fijn aan MVC, dat alles convention based is en je dus wel moet houden aan die structuren.
Carpe Libertatem
Ik ben m'n code aan het doccen met phpdoc maar ik krijg inline @links niet werkende...
Ik heb nu dit
En in m'n docs ziet dat er dus zo uit..
http://manual.phpdoc.org/(...).inlinelink.pkg.html
Kijk ik nou ergens overheen waardoor die geen mooi linkje ervan maakt?
Ik heb nu dit
| 1 2 3 4 5 6 7 8 9 10 | <?php /** * sends a {@link http://tools.ietf.org/html/rfc2812#section-3.3.1 PRIVMSG} * @param string $user The user to send as * @param string $to The reciever * @param string $message The message to send * @see write() */ function privmsg ($user, $to, $message) ?> |
En in m'n docs ziet dat er dus zo uit..
http://manual.phpdoc.org/(...).inlinelink.pkg.html
Kijk ik nou ergens overheen waardoor die geen mooi linkje ervan maakt?
Welke versie van phpDocumentor gebruik je? Je linkt naar een oude versie, en als je die nog gebruikt zou ik je phpDocumentor2 aanraden.quote:Op donderdag 31 juli 2014 00:35 schreef d4v1d het volgende:
Ik ben m'n code aan het doccen met phpdoc maar ik krijg inline @links niet werkende...
Ik heb nu dit
[ code verwijderd ]
En in m'n docs ziet dat er dus zo uit..
[ afbeelding ]
http://manual.phpdoc.org/(...).inlinelink.pkg.html
Kijk ik nou ergens overheen waardoor die geen mooi linkje ervan maakt?
Bedankt voor de tip.quote:
[..]
Ook al eens naar phpDocumentor gekeken? Die wordt nog actief ontwikkeld.
Volgens mij moet je de { } weghalen. Never mind, ze beginnen het voorbeeld met hoe je het niet moet doen (ook zo handig).quote:
Ik ben m'n code aan het doccen met phpdoc maar ik krijg inline @links niet werkende...
Ik heb nu dit
[ code verwijderd ]
En in m'n docs ziet dat er dus zo uit..
[ afbeelding ]
http://manual.phpdoc.org/(...).inlinelink.pkg.html
Kijk ik nou ergens overheen waardoor die geen mooi linkje ervan maakt?
In theory there is no difference between theory and practice. In practice there is.
Oh, zit ik in oude documentatie te neuzen?quote:
[..]
Welke versie van phpDocumentor gebruik je? Je linkt naar een oude versie, en als je die nog gebruikt zou ik je phpDocumentor2 aanraden.
Ik heb phpdoc gister gedownload, heb nu de laatste versie 2.6.1. Even zoeken naar de juiste documentatie dan maar
edit: in de huidige docs staat het precies 't zelfde:
http://www.phpdoc.org/doc(...)hpdoc/tags/link.htmlquote:{@link [URI] [<description>]}
[ Bericht 15% gewijzigd door #ANONIEM op 31-07-2014 11:58:49 ]
In dat grote zwarte blok bovenaan de pagina staat duidelijk:quote:
[..]
Oh, zit ik in oude documentatie te neuzen?
Ik heb phpdoc gister gedownload, heb nu de laatste versie 2.6.1. Even zoeken naar de juiste documentatie dan maar
edit: in de huidige docs staat het precies 't zelfde:
[..]
http://www.phpdoc.org/doc(...)hpdoc/tags/link.html
quote:The effects of the inline version of this tag are not yet fully implemented in PhpDocumentor2. There’s only URI support (i.e. no support for Structural Elements), and even that is available only in long descriptions. This is a known issue that is sure to be fixed before the final release of PhpDocumentor 2.0.
EN daarachter staat "There is only URL support", dat wil ik dus juist.quote:Op donderdag 31 juli 2014 12:40 schreef Rockfire het volgende:
[..]
In dat grote zwarte blok bovenaan de pagina staat duidelijk:
[..]
[ Bericht 1% gewijzigd door #ANONIEM op 31-07-2014 12:43:07 ]
Nee, jij wil ook een descriptionquote:
[..]
EN daarachter staat "There is only URL support", dat wil ik dus juist.
Dat "only URI support" slaat op waar je naar toe kunt linken. Je kunt niet verwijzen naar iets anders dan een link, zoals bijvoorbeeld een variabele.quote:
En die description slaat op de opbouw van een DocBlock. In het kort heb je 3 onderdelen, een summary, een description en tags. De volgorde is belangrijk. De notatie {@link } werkt alleen in descriptions en niet in summaries (dus niet in de eerste regel).
Ja, die {@link .. } werkt alleen in descriptions en niet in de summary waar je het nu probeert te gebruiken. Zie ook mijn post hierboven.quote:
Ik ben m'n code aan het doccen met phpdoc maar ik krijg inline @links niet werkende...
Ik heb nu dit
[ code verwijderd ]
En in m'n docs ziet dat er dus zo uit..
[ afbeelding ]
http://manual.phpdoc.org/(...).inlinelink.pkg.html
Kijk ik nou ergens overheen waardoor die geen mooi linkje ervan maakt?
Mogelijke oplossingen:
| 1 2 3 4 5 6 7 8 9 10 11 12 | <?php /** * sends a privmsg * * @link http://tools.ietf.org/html/rfc2812#section-3.3.1 PRIVMSG * @param string $user The user to send as * @param string $to The reciever * @param string $message The message to send * @see write() */ function privmsg ($user, $to, $message) ?> |
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 | <?php /** * This is my one line summary * * This is my multi-line description that contains * an inline link: {@link http://tools.ietf.org/html/rfc2812#section-3.3.1 PRIVMSG} * * @param string $user The user to send as * @param string $to The reciever * @param string $message The message to send * @see write() */ function privmsg ($user, $to, $message) ?> |
Teksten naar eigen voorkeur aanpassen
