You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Restier is a fantastic platform. An example of what magic can happen if you think creatively and write great code. The problem is, the documentation expects that you can just point people to convoluted samples, and they will magically figure out how to use it.
But unlike real magicians, software developers actually have to explain how the trick works
with zero rhyme or reason.
The effect of Microsoft's communication is this: "Want to learn Restier? Just read this undocumented, 600 LOC file that doesn't contain a single real-world scenario. if you stare at it long enough, you'll get it. You know, like one of those 3-D Magic Eye Posters."
We need to separate the concept of Unit Tests from Samples, and build a single, legitimate, fully-commented and fully-documented, REAL WORLD sample of how to use this system. It needs to be simple, it needs to be thorough, and it needs to not be another "to-do list" app.
The text was updated successfully, but these errors were encountered:
We have a new sample in the codebase that covers the Northwind database. It's not amazing or complex, but it covers a few simple scenarios that we will definitely add to over time. I'm gonna close this for now, but we'll keep an eye on the samples.
Restier is a fantastic platform. An example of what magic can happen if you think creatively and write great code. The problem is, the documentation expects that you can just point people to convoluted samples, and they will magically figure out how to use it.
But unlike real magicians, software developers actually have to explain how the trick works
with zero rhyme or reason.
The effect of Microsoft's communication is this: "Want to learn Restier? Just read this undocumented, 600 LOC file that doesn't contain a single real-world scenario. if you stare at it long enough, you'll get it. You know, like one of those 3-D Magic Eye Posters."
We need to separate the concept of Unit Tests from Samples, and build a single, legitimate, fully-commented and fully-documented, REAL WORLD sample of how to use this system. It needs to be simple, it needs to be thorough, and it needs to not be another "to-do list" app.
The text was updated successfully, but these errors were encountered: