haxordx / haxor-challenge-pubnub-js-getting-started

0 stars 2 forks source link

The tutorial for completing the basic javascript implementation was harder to find #3

Open mmcguff opened 1 year ago

mmcguff commented 1 year ago

The SDK for JavaScript(Web) was nested inside the build in 10 lines of code demo link. This was fine but made this harder to work with.

Overall there is a lot of great docs, videos and examples on the website but there hasn't been a ton of thought about the DX so moving through it is a lot of reading, trail and error. I found several different examples in different places guiding me to use a plain SDK here or us the github example there.

haxorbot commented 1 year ago

Awesome! Thanks for participating in Haxor. A human will review your contribution soon!

mmcguff commented 1 year ago

Overall the biggest thing I IMO that could done to improve the developer experience using this would be bring the docs and tutorials together in the same place on the site. Right now the Tutorials for how to connect with the various SDKs live in a different place than the reference documentation. These should be combined to be in the same place. That way the developer looking to integrate doesn't have to go to multiple pages on the site to find whatever they need to integrate with the PubNub Solution.

Overall everything a users needs is there but it just not what I would consider easy to find what you are looking for. The information needs to be organized better.