Formerly /u/Zagorath on the alien site.

  • 6 Posts
  • 524 Comments
Joined 1 year ago
cake
Cake day: June 15th, 2023

help-circle

  • Yup absolutely. I mentioned web APIs because that’s what I’ve got the most experience with, but .h files, class library public interfaces, and any other time users who are not the implementor of the functionality might want to call it, the code they’ll be interacting with should be tailored to be good to interact with.


  • If the doco we’re talking about is specifically an API reference, then the documentation should be written first. Generate code stubs (can be as little as an interface, or include some basic actual code such as validating required properties are included, if you can get that code working purely with a generated template). Then write your actual functional implementation implementing those stubs.

    That way you can regenerate when you change the doco without overriding your implementation, but you are still forced to think about the user (as in the programmer implementing your API) experience first and foremost, rather than the often more haphazard result you can get if you write code first.

    For example, if writing a web API, write documentation in something like OpenAPI and generate stubs using Swagger.



  • This kind of stuff? None. It’s shockingly bad.

    But a real Age of Empires game? Hells yes. This was announced not long after the AoE2 and AoE4 ports to console & controller had shown to be successful (at least critically—no idea how they’re doing commercially). So I thought that they had cracked a way to do satisfying RTS gameplay on a mobile device. It’d be great to be able to play a quick Skirmish on the bus, or while spending time away from home without my computer.

    So when a few aoe creators showed previews of the game back in February this year, I was rather surprised and very disappointed to see that the game has absolutely zero resemblance to an Age game. That the worst fears of it being a shitty rip-off were completely true. Thanks to those previews, I was not surprised on release this week—though the extent of just how bad even the narrative side of this is was still overwhelming.








  • Nah I think they’re more or less right. I’d maybe pull it back 3 or 4 years, but not as far as 2004.

    What killed off the old wild web was the popularity of centralised platforms. Facebook (open since 2006, really started taking off more around 2008/9), YouTube (first video 2005, really takes off from 2007/8), and Reddit (self posts first allowed in 2008), and other things like that which were admittedly great for allowing more people to share their creations with the world, but we’re disastrous for the open web, because they killed off independent blogs, forums, and other smaller websites.