[PHPhulp] Tutorials en Scripts, doorgaan of stoppen?

Hallo Wouter,

Ik denk dat het deels komt hoe sommige mensen hier kritiek geven.
Wat voor de mensen die kritiek geven "normaal is" is voor de persoon die een script of tutorial schrijft bot en onbeschoft.

Je hebt hier veel mensen die scripts maken maar niet perse oop toepassen.
Hier wordt bijna direct kritiek opgegeven ( best veel gezien ) ipv dat de persoon in kwestie ten eerste het script of de tutorial complimenteert over de gemaakte inspanning.

Let wel dat dit mijn mening is op wat ik heb gezien.
Hierdoor zou ik dus geen script of tutorial hier toevoegen omdat men TE veel in de regels die hij/zij hanteren zitten..

M.V.G,
Wouter.

Zelf ben ik verre van perfect om een tutorial te schrijven. Ik heb trouwens nooit een cursus gevolgd om php of andere webtalen te leren.
Alles wat ik ken is hier op het forum en tutorials te lezen en te experimenteren.
Dus zelf zal ik nooit eentje schrijven.

Persoonlijk zou ik graag korte en nuttige scripts/tutorials willen zien die je kunt implementeren in je eigen code. Dus niet scripts in de trant van: zo maak je een compleet loginsysteem. Maar eerder kleine, maar wel duidelijk uitgelegde scripts als:

- hoe beveilig je user input (wat moet je allemaal strippen, sql injection e.d.)
- hoe hash je een wachtwoord (en dan met de nieuwste technieken)
- hoe sla je een datum op in een database en hoe toon je deze op een mooie manier

Eigenlijk vooral de praktische, handige dingetjes die je direct in je eigen code kunt gebruiken. Dat lijkt me wel heel handig. En dan met een stap voor stap uitleg erbij.

Verder vind ik ook wel dat de scripts een beetje verstopt zijn. Ze vallen niet heel erg op in het linkermenu.

Het moet, vind ik, vooral nuttig zijn zodat eigenlijk iedereen het zou kunnen toepassen. Ook bijv. hoe toon je jouw Twitter-berichten op je eigen website.

Ik ga wel mee met Ozzie. Ik vind niet dat de links naar de tutorials te verstopt zijn maar ik vind dat het maken van een tutorial een beetje belabberd werkt met al die pagina's toevoegen vooral. Verander dat in hoofdstukken en de hoofdstukken gewoon onder elkaar op één pagina. Daarbij kunnen eventueel ankers gebruikt worden. Ook werkt het script niet helemaal lekker als je met verschillende pagina's gaat schuiven.

Daarnaast vind ik persoonlijk zou er een index pagina moeten komen voor de tuts waarin je snel en makkelijk kunt zoeken op een keywoord of in een rubriek zoals bijvoorbeeld sql, javascript, injection, login etc etc

Bovendien zouden mods er voor moeten zorgen dat de kwaliteit bewaakt wordt en verbeteringen of vernieuwingen in de scripts moeten aanbrengen. een tut over mysql_ functies dat vijf jaar terug actueel was is nu gewoon hopeloos ouderwets en dat moet er gewoon uit.

Daarnaast zou het mij helpen als jullie een mogelijkheid boden om gewoon een tekstdocument aan te leveren.

Ik ben het eens met Ozzie en Frank. Voordat men met code tutorials aan de slag gaat is het daarnaast ook zinvol om in tutorials de basics uit te leggen. De drie die Ozzie noemt maar ook bijvoorbeeld de relatie php en MySQL (of andere database). Je ziet bijvoorbeeld regelmatig dat programmeurs hele en meerdere database tabellen ophalen en aansluitend de gegevens in php loops gaan processen om iets te vinden om de eenvoudige reden dat de join niet begrepen wordt. GROUP BY is ook zo'n leuke, soms heeft iemand geen idee wat exact doet maar het levert op een of andere manier het gewenste resultaat overigens zonder dat er sprake is van enige aggregate functionaliteit in de query. Kortom, veel try on error zonder dat er begrepen wordt wat code doet.

>> Bovendien zouden mods er voor moeten zorgen dat de kwaliteit bewaakt wordt en verbeteringen of vernieuwingen in de scripts moeten aanbrengen.

Dat is ook inderdaad een hele goede. Een jaar of wat geleden was md5 de standaard om wachtwoorden te hashen. Nu is het weer wat anders. In de script library zou dat dan moeten worden geupdate.

>> Voordat men met code tutorials aan de slag gaat is het daarnaast ook zinvol om in tutorials de basics uit te leggen.

Exact. Zonder de basics uit te leggen, is een tutorial eigenlijk niet zo heel zinvol, want dan is het vooral een kwestie van copy/paste materiaal. Om die reden pleit ik dus ook voor kleine scripts/snippets die iets op een heel duidelijke manier uitleggen zodat iedereen het begrijpt. Het beveiligen van user input is iets wat op iedere website van toepassing is, maar wat is nu eigenlijk de beste manier? Hoe sla je datums op, in welk formaat? Dat soort dingen lijkt me wel handig om een naslagwerk van te hebben.

Ik denk ook dat het te maken heeft met de inmiddels grote wanorde die inde script en tut librairy heerst. Dingen zijn lastig te vinden en wat je vind is oud. Ik ben voor het compleet leeghalen ervan en weer eigentijdse scripts uploaden. Neem even een zinvol voorbeeld van het "loginsysteem" er zijn er veel te veel maar niets is meer van nu.
Een frisse wind is al een goede stap dus.

Verder denk ik dat doordat men destijds bedacht heeft om de datum weg te halen bij de tijd onder het laatste topic / reactie gedeelte in het sidepanel het minder overzichtelijk is geworden van wat er nu recent geplaatst is en niet. Ik ben dus ook voor het weer weergeven van datum en tijd.

Bedankt voor de vele suggesties! Goed om zo ook andere invalshoeken te zien.

Het grootste probleem lijkt hem te liggen in 2 dingen: Het systeem werkt niet handig en het is niet duidelijk wat er van je verwacht wordt.
Om even in te haken op G P, natuurlijk mag je tutorials schrijven wanneer je het zelf hebt geleerd. Het grootste deel, waaronder ik, hebben het hier zelf geleerd. Je kan dan alsnog goed zijn in een klein dingetje, of bijvoorbeeld 2 dagen zitten debuggen op een dom foutje die je wil delen met de rest, zodat die het snel kunnen oplossen. Dit soort onderwerpen zijn perfect voor een tutorial.

De suggesties voor tutorials van Ozzie is een goed voorbeeld van zulke handige praktische tutorials. Ozzie, jij hebt ook al redelijk wat jaartjes ervaring met PHP en hebt ook erg goed nagedacht over sommige onderwerpen, wat houdt jou tegen om kleine tutorials te schrijven? (merk op, dit is natuurlijk niet aanvallend bedoelt, slechts informerend.)

Ik ben het zeer eens met Wouter (1e comment)
Er wordt zoveel kritiek op de scripts e.d geleverd dat het niet aanspoort om een tut te plaatsen.

Ik vindt het daarom zelf ook altijd leuker bij stackoverflow omdat daar hulp wordt geboden en niet kritiek wordt gegeven omdat de manier hoe de bepaalde developer het doet en zijn manier juist is.

Linksom of rechtsom, de manier is niet super belangrijk het gaat erom dat je er komt. En je kan dan natuurlijk wel suggesties aandragen.

Ik zelf heb ook weleens commentaar op bepaalde dingen maarja ben ook maar mens en houdt gewoon niet van bepaalde softwares die bestaan.
Zelfde dan je Xbox en Playstation hebt of iOS en Android.

Ook is het niet handig om een bestand zo te uploaden en als je het wilt bewerken dat je het moet weggooien.
Zoiets als Github is makkelijk, een textbewerker waar je je script in kan plakken. En een upload mogelijkheid.

Oh en een gemakkelijk overzicht wat er al bestaat, want vaak krijg je de melding van "die bestaat al" ofzo.

>> wat houdt jou tegen om kleine tutorials te schrijven?

Op dit moment 2 dingen. Ten eerste dat ik helaas momenteel geen tijd over heb (wellicht in de toekomst), en ten tweede dat ik geen opleiding hierin gehad heb. Ik weet er uiteraard wel het nodige vanaf, maar ik vermoed dat mensen die wel zijn opgeleid dingen vanuit hun opleidingsperspectief beter kunnen uitleggen. Maar goed, ik zal het in gedachte houden, maar voorlopig dus geen tijd...

Nog even terugkomend op de vraag zelf. De complete library leeggooien en opnieuw opbouwen zou geen gek idee zijn. Veel tutorials zijn zwaar verouderd. In eerste instantie zou ik me dus vooral richten op kleine en praktische, direct toepasbare tutorials. Het is onmogelijk en onwenselijk om het bouwen van een complete website in een tutorial te stoppen, maar er zijn altijd onderdelen die iedereen nodig heeft. Gewoon hele kleine, simpele dingen. Juist dat maakt het krachtig. Hoe maak je een formulier, hoe verbind je met een database, hoe werkt een select-statement enzovoorts. Juist die praktische dingen zou ik graag terug willen zien. Daarnaast vind ik ook dat iedere tutorial gecontroleerd moet worden alvorens deze wordt geplaatst. Ik heb regelmatig superslechte tutorials voorbij zien komen en waarin dan ineens reclame wordt gemaakt voor de website van degene die de tutorial heeft geschreven. Dan lijkt het erop dat zo'n tutorial enkel als verkapte reclame dient. Maar goed, die tutorials worden dan gelukkig snel weer verwijderd... maar ze hadden in eerste instantie nooit getoond mogen worden.

Wat ik overigens ook leuk zou vinden, maar wellicht is daar geen behoefte aan (wat vinden andere gebruikers...? laat het horen) als er wat meer tutorials zouden komen over het inrichten en bijhouden van een server. Ook hier weer heel simpel... Hoe schakel je root-toegang uit, hoe stel je een firewall in enzovoorts. Er zitten hier een paar experts op server-gebied die heel veel waardevolle informatie kunnen geven (dan denk ik bijv. aan Aar en Willem VP) die nergens op het forum is terug te vinden. Ik zou dat heel waardevol vinden.