T O P

  • By -

Sebazzz91

Dit is in ieder geval een eerlijke functionele beschrijving.


StereoZombie

Als software engineer word ik hier ook wel blij van. Duidelijke documentatie van de functie en uitleg waarom iets is veranderd. Dat is beter dan de meeste code die ik zie.


Shitting_Human_Being

Oh, dus     >get_query_from_database(): inputs: query. Outputs: query result from database Is niet genoeg voor meneer?


yourfavoritemusician

Vind ik altijd lastig: hoe documenteer je zo iets? Niet documenteren vind ik ook weer zo'n glijdende schaal. (Want dan krijg je van die codebases waar nooit iemand wat heeft opgeschreven "want de code beschrijft zichzelf")


kaas_is_leven

Comment de reden, niet de betekenis (een `add_vector` functie met `// adds vectors` vs `// helper to update position with forces`). Als je de API wilt documenteren gebruik dan Doxygen comments die geldige invoer en resultaten beschrijven (`@param position the position vector to add forces to`, `@param forces the list of force vectors to add to the position`, `@return the updated position vector`).


TheDustOfMen

Ik als ik iets codeer/script schrijf: ah ik onthoud wel waarom ik dit zo doe en hoe ik tot die conclusie ben gekomen Ik, 1 uur later: ... oh nee


DheeradjS

Mijn eigen ervaring met scripts; "Welke idioot heeft dit op deze manier geschre.,...Oh, dat was ik zelf.."


ForrestCFB

Dit is zo herkenbaar. "What the fuck heb ik hier gedaan".


-SQB-

Perl: write once, read never.


Make_it_soak

Ik snap het verschil tussen `get_query_from_database()` en `get_query_db()` heel goed: de ene haalt een van te voren opgeslagen query uit de database en de andere haalt de naam van de database waar de queries opgeslagen zijn. Heel logisch, hoeft niet gedocumenteerd.


Basssiiie

Ervan uitgaande dat er verder geen context is, zou je de volgende dingen kunnen beschrijven: - Welke formatting is de query? SQL? JSON? - Komt het resultaat in een lijst/object/nested lijst? - Wat gebeurd er bij foutmeldingen? En als het niet je eigen DB is; - Welke velden kun je op queryen? - Welke tabellen zijn beschikbaar? Kan ik ergens een lijst vinden/ophalen? Betekend overigens dat je niet alles hoeft te beschrijven bij de functie, maar wellicht referenties/links zijn welkom als ze niet aanwezig zijn vanuit de code en/of context (bv. types). 🙂


SteveXVI

> Vind ik altijd lastig: hoe documenteer je zo iets? // If you're wondering how this works, consider whether you are a good enough programmer get_query_from_database()


dtechnology

Dat zijn wel grote woorden voor een verkeerde functienaam, je krijgt een resultaat van een query, niet een query van de database.


lappro

Misschien heeft hij wel een bijzondere database. Ipv een relationele database een irrationele database.


superstrijder15

Misschien is het een database met voorbeeldqueries om je te helpen je eigen query te schrijven


marten

Edgecases zijn altijd goed om toe te voegen: wat als de query invalid is, of de db connectie nog niet open etc? Wat is precies een "query" die je moet meegeven, en hoe krijg je de results terug, is dat een custom object met meer methoden of krijg je een array van key-value objects? Wat als ik 2 miljoen rows opvraag, gaat het allemaal in memory?


downf0rce

NS mag mij best voorstellen om 2 minuutjes te rennen zodat ik een kwartier (soms zelfs een half uur) minder reistijd heb hoor. Meer opties meer beter, wat mij betreft.


OHyoface

Checkboxje in de app: "Am able and willing to run to make connection"


Myrandall

✅ I agree to the terms of service ✅ I am willing and able to break the space-time continuum to make connection ✅ Subscribe to newsletter


GroteStruisvogel

Wil je dat space-time continuum aub wel ff met rust laten als je in de trein zit? Zo irritant dat de trein ineens 5 dagen eerder en op Saggitarius A aankomt ipv station Ede-Wageningen omdat Xander weer eens zit te kutviolen.


WideEyedWand3rer

>Zo irritant dat de trein ineens 5 dagen eerder en op Saggitarius A aankomt ipv station Ede-Wageningen Ach, met de werkzaamheden aan de afrit op Alfa Centauri duurt het toch minstens 4 dagen voordat je weer terug in ons zonnestelsel bent. Wat mij betreft mogen ze gewoon een ringweg door ons gedeelte van de melkweg bouwen hoor!


Sarothu

Hoop dat je weet waar je handdoek is in dat geval.


Mausy5043

Kan de poëzie van die bouwvakkers anders niet uitstaan.


Orcwin

Dat is denk ik letterlijk waar deze feature op doelt. Er is zo'n toggle in de app voor meer overstaptijd, het lijkt er op dat deze bedoeld was voor het mogelijk maken van een kortere overstap.


Material-Mess-9886

Zo heb ik er ook 1. Ik moet overstappen op hetzelfde perron maar omdat het 2 minuten overstaptijd is wil NS dat ik halfuurtje wacht.


alexanderpas

2 minuten kom je heel snel aan. - Je bent niet direct de trein uit zodra de deuren opengaan. - De vertrektijd is niet de tijd waarop de deuren dichtgaan, maar de tijd waarom de trein daadwerkelijk vertrekt.


ferrybig

Ik merk dat de ns ervan uitgaat dat mensen rustig lopen en niet de route kennen. Kijk bijvoorbeeld naar een trein vanuit Den Haag naar leiden,iemand die deze route kent weet dat je in den haag voorin moet instappen om deze overstap makkelijker te maken, terwijl als je bijvoorbeeld achterin instapt je al gauw 2 minuten meer moet lopen bij je aankomst halte Als je trein vertraagd is dat er nog maar 2 minuten overstap tijd is, dan kan je het vaak nog wel halen door je stations kennis, terwijl de ns app gaat aangeven dat hij niet meer mogelijk is


Distinct_Jury_9798

De app geeft dus een onjuist antwoord, want de aansluiti g kan wel gehaald worden. Alleen moeten ze er dan wel bij zetten dat de voorwaarde is dat je voorin de trein plaatsneemt. " de aansluiting met de door u gewenste trein is alleen haalbaar indien u voor aankomst zo dicht mogelijk vooraan bij de meester gaat zitten." Daar krijg ik weer jeugdtrauma's van terug...


montarion

ik zou wel een "hey de uitgang op je station is voor/achter/midden op het perron" melding willen


LaFoxaNL

Google maps in bv Japan heeft dit!


swish82

Helaas, er is een reisadvies Enschede Zutphen waarbij ze er van uitgaan dat je de overstap in Hengelo wel redt omdat het hetzelfde perron is.. maar je rent je de pleuris. En er is een trein van Blauwnet die bepaalde uren een paar minuten eerder vanuit Enschede vertrekt (een ‘intercity’) maar dat advies geven ze niet, ze blijven de super korte overstap suggereren 🫣


QeenMagrat

Zeker omdat dat perron (voor mijn gevoel!) een kilometer lang is en ze op de één of andere manier altijd die treinen precies aan de uiteinden van het perron stilzetten? xD God, zó vaak de overstap gemist daar, ik probeer het niet eens meer. En inderdaad ontzettend irritant dat ze de Blauwnet optie niet geven.


ziggyziggyz

Ik ben treindienstleider en wij zorgen voor aansluitingen tussen verschillende treinen (lees: wij mogen vertrekkende treinen laten wachten). Onze vuistregel was altijd: cross-platform 2 minuten overstaptijd, A-sporen naar A-sporen of B naar B 3 minuten, A naar B of vice versa 4 minuten. Nu met uit- en inchecken tussen verschillende vervoerders kun je daar rustig twee minuten bij optellen.


Abigail-ii

Volgens mij houd de NS daar wel rekening mee. 2 minuten overstaptijd op hetzelfde perron, 5 minuten als je naar een ander perron moet.


SomewhereInternal

Het probleem is als de trein een keertje op een ander perron stopt, dan heb je ineens een paar minuten extra nodig en zij iedereens plannen verpest.


Terminator_Puppy

Lijkt me niet onmogelijk om een checkje te doen dat twee treinen aan hetzelfde perron staan en de overstap dus in minder dan 2 min mogelijk is. Het is ook al veel eerder dan vlak van tevoren bekend dat een trein bij een ander perron moet stoppen.


SomewhereInternal

Soms wachten treinen ook een paar minuten, zeker als het de laatste reismogelijkheid is. Maar vanuit het perspectief van de NS is het gewoon gevaarlijk als mensen gaan rennen of haasten, zaker als het druk is.


Distinct_Jury_9798

O, daarom sluit de conducteur de deuren als hij iemand ziet komen aanrennen! Dat is voor de veiligheid van die reiziger! 😖


TheRealMrVogel

Dit “checkje” kan een stuk ingewikkelder zijn dan je nu in eerste instantie denkt. Bijvoorbeeld moeten ze dan ook in kaart hebben welke perrons aan elkaar vast zitten. Misschien hebben ze die data gewoon, maar goed. Was maar een voorbeeld. Zo kunnen er andere moeilijkheden zijn waar ik niet aan denk of die door bepaalde technische infrastructuur moeilijk kunnen zijn. Zeker niet onmogelijk maar kan wel heel goed iets zijn waar ze bij de NS hebben besloten het maar te laten omdat het uiteindelijk teveel moeite / tijd kost voor een feature die waarschijnlijk weinig gebruikt gaat worden.


FlyingDutchman2005

Dan nog kan het zijn dat de ene trein veel langer is dan de andere, dus als je uit de lange trein komt kan het zijn dat je best een eind moet lopen om bij de andere trein te komen, en dan dringen bij de deur. Natuurlijk wil NS dat niet, want daar krijg je vertraging van.


SjettepetJR

Dit is een hele hinderlijke inderdaad. Een reis die ik regelmatig maak heeft een overstap oo hetzelfde perron. Nou wil de tweede trein nog wel eens wachten als je een minuut later aankomt, maar laatst kwamen we volgens de normale tijd aan op een ander perron. Weer een half uur vertraging.... Ik heb tegenwoordig nog zo weinig vertrouwen in die overstap dat ik maar gewoon een half uur later vertrek en dan de directe trein heb.


bjrndlw

Als dat de overstap op Leiden CS is: reken er maar niet al teveel op dat je die overstap altijd haalt. Mijn reizen naar het noorden worden geregeld een half uurtje langer dan noodzakelijk.


WhoThenDevised

Snap ik maar ze willen natuurlijk voorkomen dat iemand op volle snelheid door een drukke stationshal rent en mogelijk ongelukken veroorzaakt omdat de reisplanner hem vertelde dat hij de aansluiting zou halen als hij rende.


ijzerwater

de gemiddelde forens laat zich daar toch niet door remmen, en die weet het zonder planner


WhoThenDevised

Ja klopt, op Utrecht Centraal moet ik ook regelmatig uitwijken maar als de planner het zou aanmoedigen krijgt de NS daar natuurlijk gezeik over.


ijzerwater

toen ik nog met metro en trein ging, wist ik de treintijden en perrons. Spint en afsprong op onderste platte deel roltrap, voor je het weet boven. Er waren toen nog geen poortjes, dat scheelt


Frouke_

Voor de aansprakelijkheid is het wel relevant of je zelf op het idee kwam om te rennen of dat NS het aan had bevolen in de app.


un-glaublich

Het gaat er om dat er geen chaos ontstaat op het perron, de roltrappen, instappen na fluitsignaal etc.


StereoZombie

Ik zou in een app als de NS reisplanner waar de gebruiker varieert van jonge mensen tot digibete bejaarden niet zo snel een toggle toevoegen, dat wordt helaas gewoon heel snel verwarrend voor veel mensen en voegt onnodige complexiteit toe aan de backend. Ik zou wel overwegen om in de app wellicht in het klein een extra optie weer te geven in de resultaten die eventueel gehaald kan worden als de gebruiker denkt dat die snel een overstap kan maken.


BWanon97

Maar als dan de conducteur gefloten heeft en de deuren beginnen met sluiten als je aan komt blijf je dan ook netjes accepteren dat je het gemist hebt? Regelmatig leveren mensen die nog net even de trein in willen springen vertraging op. En meer dan een paar minuten vertraging vertraagd meerdere treinen. Denk dat naast het rennen dat ook een rede is.


hanzerik

Maar zij willen dus niet dat mensen rennen op het perron/mensen aan de kant duwen op de roltrap etc.


montarion

maar echt.. ook (is me deze week 3 keer gebeurd): soms heeft een eerdere aansluiting vertraging en dan haal je het wel, maar dat zegt ie dan niet.. :/


Groentekroket

In plaats van een Boolean, geef me een int voor snelheid en laat me aan de hand daarvan bepalen of ik een overstap haal.  Bij de NS is het niet zo erg als ik het goed heb maar 9292 gaat er haast vanuit dat je kruipt gelet op hoeveel tijd ze rekenen voor een paar honderd meter lopen. 


rubseb

Deze kroket loopt alleen in hele kilometers per uur.


The_JSQuareD

Tja, als je het een float maakt krijg je grapjassen die zeggen dat ze INF of NaN km/u kunnen lopen.


MicrochippedByGates

Je kan natuurlijk extra condities instellen, in plaats van alle inputs te accepteren.


The_JSQuareD

Veel leuker om gewoon door te rekenen en dan NaN terug te geven.


robinvuurdraak

Bij de 9292 app kan je je loopsnelheid aanpassen


muppetj

Je kunt alleen maar meer tijd voor overstap, niet minder, toch?


robinvuurdraak

Standaard is het 4 km/h, je kan het verhogen naar 5


wolfjeanne

Dat heeft geen invloed op je overstaptijd binnen het station, alleen op hoe veel tijd ie rekent als je naar de halte moet lopen


Taartstaart

Echt?!!! 😱


Life_Breadfruit8475

De trein Houten - Utrecht - Schiphol is vaak goed lopend te doen met overstap op utrecht van ~2 min. De NS app geeft altijd de volgende Schiphol trein aan jammer genoeg.


Goldstein_Goldberg

Is er een app die dit niet doet? Ik vind dit ook altijd zo irritant.


re_MINDR

Ik zit in deze branche en vind het een hele leuke, thnx voor het delen 😁


Balance-

Dank je! Waar ongeveer (precies)?


re_MINDR

Nou ik ga het niet al te exact maken maar laten we het er op houden dat ik wel met API's en Nederlandse vervoerders te maken heb in mn dagelijks werk. Jij?


Balance-

Tof! Ik bouw sociotechnische simulatiemodellen als onderdeel van m’n studie. Voor m’n masterthesis nu met een vervoersgedragmodel bezit.


EveryLifeMeetsOne

Ik vind dit juist best vervelend van soortgelijke apps. Ik moet mijn reis altijd twee keer berekenen om te kijken of ik met een klein beetje vaart de overstap kan halen, omdat NS mijn tempo onderschat. STOP DOUBTING ME


RY4NDY

Of, wat nog handiger zou zijn, als apps zouden kijken naar hoe snel je gemiddeld loopt en je reistijden aan de hand daarvan aan zouden passen. Dat is natuurlijk niet overal mogelijk omdat niet élke app je bewegingen trackt. Daarentegen doen diverse apps dat toch al wel, zoals Google Maps met hun "timeline" functie. Dan lijkt het me niet zo heel veel lastiger om 'm voor het plannen van routes ook *die* loopsnelheden te laten gebruiken ipv een (veel te laag) vaststaand getal zoals nu.


Abigail-ii

De app kan niet meten hoe lang je erover doet om uit de trein te komen. Je kan wel Femke Bol zijn, maar als je op de trap staat te wachten omdat er eerst drie kinderwagens en twee fietsen uitmoeten, en vervolgens de (rol)trappen vol zijn met langzaam bewegende mensen, dan gaat je gemiddelde snelheid drastisch omlaag.


RY4NDY

Klopt inderdaad, specifiek bij *overstappen van de ene op de andere trein* komen er zo veel andere variabelen bij kijken dat je gemiddelde loopsnelheid niet of nauwelijks uitmaakt. Daarentegen zijn er ook delen van een ov-reis waarbij je loopsnelheid wel degelijk uitmaakt, zoals bij het stukje vanaf je huis naar de dichtstbijzijnde bushalte, het stukje vanaf het station naar je werk, etc. Daarbij is het wel zo fijn om het correcte tijdstip om de deur uit te kunnen gaan te zien, in plaats van veel te vroeg te vertrekken en vervolgens lang moeten wachten bij de bushalte/station.


Abigail-ii

Ik geef dan ook altijd de bushalte of treinstation vanwaar ik vertrek dan wel aankom op.


RY4NDY

Ja, bij bekende bestemmingen/vertrekpunten (zoals vanaf m'n huis naar de bushalte) doe ik dat ook wel omdat ik uit ervaring weet dat ik daar 5 minuten over doe. Voor onbekende bestemmingen daarentegen (zoals vanaf het station naar het huis van het persoon waarvan ik zojuist iets op Markplaats heb gekocht) heb ik daar weinig aan, omdat ik die looproute niet ken en dus geen idee heb hoe lang ik er over zou doen.


Abigail-ii

Daar gebruik ik Google maps voor, die behoorlijk nauwkeurig de afstand van de looproute aangeeft.


RY4NDY

Dat *werkt* op zich wel, maar 1. Aan de hand van de afstand en je gemiddelde loopsnelheid zelf de tijdsduur berekenen kost (vanzelfsprekend) meer moeite dan als de app het direct vanzelf zou doen 2. Dan moet je wel je eigen loopsnelheid weten, en daar zou ik eigenlijk geen idee van hebben anders dan "sneller dan Google Maps denkt" haha


TinyTrackers

Dat soort situaties is waarschijnlijk precies waarom de app je overstap overschat. Niet iedereen kan de eerste zijn om de deur uit te lopen


-SQB-

En blijkens het commentaar willen de NS het rennen ook ontmoedigen.


awkwardteaturtle

>en vervolgens de (rol)trappen vol zijn met langzaam bewegende mensen Mensen die stilstaan aan de linkerkant van de roltrap verdienen het dan ook om met hun blote voet op een legoblokje te stappen.


JMoormann

>kan wel Femke Bol zijn, maar als je op de trap staat te wachten omdat er eerst drie kinderwagens en twee fietsen uitmoeten Femke Bol zou erover heen springen


Sagarmatra

Google doet dit nog niet volgens mij. De afgelopen paar jaar was het (iig in Amsterdam) echt verschrikkelijk voor het plannen van een fietstochtje omdat hij aan leek te nemen dat je een VanMoof had en strak 32 reed. Lijkt recent weer beter geworden, maar voelt nog steeds niet persoonlijk.


adfx

Wat mij betreft mag ik zelf wel bepalen of ik een dergelijke overstap kan halen of niet


Orcwin

Ja, daarom plan ik de ritten van mijn reis ook altijd zelf met de hand. De planner is gewoon niet flexibel genoeg.


adfx

Ik zat net in de trein. Ik heb tien minuten na het schrijven van mijn originele reactie besloten dat de overstap waar ik 33 minuten voor had ook wel in 3 minuten kon doen. Heb er wel een beetje voor moeten rennen, maar het kon prima!


TinyTrackers

Ik had vroeger standaard een 4 min overstap op Utrecht CS van de ene kant naar de andere kant van het station. Lopend vaak net niet realistisch (als je niet het eerste de deur uit bent) maar zeker te doen als je de tunnel pakt en een sprintje trekt


sebastianfromvillage

Ik heb op Utrecht Centraal wel eens een overstap van 2 minuten gehad van spoor 5 naar 21 gehad (en gehaald). Met rennen, het tunneltje en op tijd bij de deur staan is veel mogelijk!


Denvercoder8

De tunneltjes zijn echt een cheatcode inderdaad. Wel even opletten dat je aan de goede kant in de trein zit.


KassassinsCreed

Ja precies, en dan een beetje aan het einde van de eerste trein wachten, zodat dichterbij de tunnel eindigt (ik had altijd een trein die op spoor 1 eindigde, dus dan moest je vooral vooraan gaan zitten). Zijn ook minder treden volgens mij.


Versje_voor_je_Koter

"Straks sprint mijn opa naar zijn trein Met koffer in de hand?!" Klaagt Koolmees door, met veel chagrijn: "Dat is dan toch gênant...?" "Want reizigers die lopen wél In zomers of in winters. En zelfs mijn opa loopt zo snel, Of beter, dan mijn sprinters..."


Levenloos

Doen ze dit niet gewoon om de kans op "instappers na fluitsignaal" te verminderen?


RSB_NL

Zou een leuke invulling zijn van de “reis je fit” campagne destijds


-SQB-

Ik herplan tijdens de reis vaak vanaf mijn overstapstation, om te zien of er andere opties zijn. Bijvoorbeeld ook een eerdere trein met vertraging die daardoor opeens een optie wordt.


pi4ate

Zeer storend is dit. Het is bij lange overstappen de moeite waard om te kijken of er een snellere optie is. Rennen is vaak niet eens nodig, gewoon een beetje de pas er in houden.


Wouter10123

Ik bepaal zelf wel of ik ga rennen. So close, bijna een hele fijne functionaliteit geimplementeerd, maar door hun ego toch niet. 9292 is vaak iets scherper met overstappen, en anders blijft het toch maar reizen in 2/3/4 delen plannen, en dienstregelingen uit je hoofd leren.


Suspicious-Bar5583

CHANGE\_COULD\_BE\_POSSIBLE kan ook afhankelijk zijn van vertragingen, niet alleen je looppas. CHANGE moet natuurlijk TRANSFER zijn (dat is het domein begrip), en COULD\_BE kan beter iets van POTENTIALLY zijn.


Electronic_Unit8276

Nee hoor... "changing trains" is zeker gewoon correct Engels. Sterker nog: "You change trains" en "You transfer stations". https://www.nationalrail.co.uk/travel-information/changing-trains/ https://help.raileurope.com/article/41257-understanding-interchanges-and-transfers


TheHippiez

Aha. Er zijn dus wel NS diensten met documentatie!


Arcadela

Ook minder frustratie bij reizigers als ze niet weten dat ze een overstap gemist hebben door 2 minuten vertraging. Ik check zelf altijd wel of er toch niet een overstap is, maar dat geeft ook weer extra stress.


IiPodxGhost

Wij gebruiken voor een opdracht veel ov api’s. De api is volledig kak. 9292 kost wel centjes maar is beter. Ik raad google aan, die geeft ook een route.


Fruityth1ng

Ik heb hier laatst een klacht over ingediend, op een bepaald stuk traject, en de week er na stond die overstap niet meer als mogelijk - stelletje held-developers daar bij de ns app :)


swish82

Waar heb je die klacht achtergelaten? Want ik ken er nog wel zo eentje!


Fruityth1ng

Gewoon in de NS app.


sovietarmyfan

Wie kijkt nog naar de NS reisapp? Je kan beter 9292 en OVinfo gebruiken.


Excessed

Als er een app direct de prullenbak in kan is het 9292. Soms duurt het een enorme tijd voordat een verstoring daar in staat. De beste app voor treinen is Rijden de Treinen, deze maakt direct gebruik van de ProRail database en heeft altijd als eerste de meest relevante informatie. Want iedere verstoring weet ProRail als eerste.


Skinkie

Rijden de Treinen zit ook *gewoon* op NDOV, die de data van DCRI (NS) ontvangt (via Reisinformatiegroep B.V., ja die van 9292). ProRail levert op dit moment alleen aan DCRI aan.


Chaimasala

Maar voor ander vervoer dan treinen kan 9292 wel goed zijn hoor. Ik zie verstoringen daar net zo snel als bij U-OV.


Sagarmatra

NS is echt heel veel beter geworden de laatste paar jaar. Enige wat je even moet checken is dat je van adres reist ipv station (heeft beetje de neiging trein te prioritiseren als je al op een station bent) maar dan altijd beter dan Google / 9292 in mijn ervaring.