docs icon indicating copy to clipboard operation
docs copied to clipboard

Add new REST history tutorials or remove the misleading tutorial card

Open Srushtika opened this issue 6 years ago • 1 comments

@tomczoink just observed that in https://www.ably.io/tutorials#tut-server-side, the following card says 'REST history' but in-fact only some of the languages in the tutorial show code and explanation using the REST client library, JS, Java etc all use realtime.
Screenshot 2019-04-25 at 00 35 49

Note that we already have a history tutorial in 'client-side' with a 'mobile' tag. I think we should add a 'browser' tag to that card and remove this other 'REST History' card from the 'server-side' section. It's not only misleading but doesn't serve much of a purpose as it still shows retrieval of history on the client-side for some publishes done by the server.

Wanted to know your thoughts before going ahead with this.

┆Issue is synchronized with this Jira Bug by Unito

Srushtika avatar Apr 24 '19 23:04 Srushtika

That is pretty misleading as is, although I do think having a section which makes it clear we have a tutorial on obtaining history from servers is good to have. I'd say in general we should make a legitimate history from servers tutorial to replace it (basically take the python/php/ruby and copy them into a new textile doc). WDYT @Srushtika ?

tomczoink avatar Apr 26 '19 08:04 tomczoink