Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create New Sample API Project #574

Closed
robertmclaws opened this issue May 27, 2017 · 1 comment
Closed

Create New Sample API Project #574

robertmclaws opened this issue May 27, 2017 · 1 comment

Comments

@robertmclaws
Copy link
Collaborator

robertmclaws commented May 27, 2017

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.

@robertmclaws
Copy link
Collaborator Author

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants