search

stormpath / stormpath-sdk-spec

Language-agnostic API specification for Stormpath SDKs.
2 stars 1 forks source link

The documentation is incomplete. #8

Closed humanismusic closed 8 years ago

humanismusic commented 8 years ago

Take this page for example: https://github.com/stormpath/stormpath-sdk-spec/blob/master/specifications/account.md which is the best I can find when looking for express options.

How are we to build on Stormpath when the full documentation isn't available?

rdegges commented 8 years ago

This isn't a complete spec just yet -- it's something we've been working on, but is in no way completed. We're still in the process of writing this all up so we can standardize our integrations between languages.

The most accurate, and up-to-date information can be found on our website, here: http://docs.stormpath.com/rest/product-guide/

humanismusic commented 8 years ago

I ended up using this tutorial: https://stormpath.com/blog/build-nodejs-express-stormpath-app/ - which worked a charm, yet wasted way too many hours yesterday trying to find key bits of info which flies in the face of Stormpath being a time and frustration saver.

Overall a great service. Put together a pack of cohesive docs (and fix the dead links on your blog) and it will be even better.

rdegges commented 8 years ago

Thank you for the feedback -- this is really useful.

I promise we'll be improving this very soon. We've been working really hard to totally re-do our docs, and are getting pretty close to launching those =) This will hopefully solve a lot of frustration in the future! <3