tutorials icon indicating copy to clipboard operation
tutorials copied to clipboard

Tutorial not working with ver 3.5

Open ashutoshsharmaindia opened this issue 7 years ago • 5 comments
trafficstars

I am trying to work with the basic tutorial involving Kafka: https://github.com/streamsets/tutorials/blob/master/tutorial-2/directory_to_kafkaproducer.md

It's not working. It seems that you user interface(UI) has changed or evolved but the tutorial is still referring to the old user interface and steps.

The moment I am at this step: Defining the Kafka Producer

There is no way I can follow it as the user interface and the navigation is not in sync with this documentation. Products like stream sets which are having sucha heavy duty user interface and the navigation should be having almost the perfect documentation and updated as per the latest versions. Or may be the tutorial should clearly specify with what versions it is going to work?

ashutoshsharmaindia avatar Oct 05 '18 20:10 ashutoshsharmaindia

Hi @ashutoshsharmaindia,

Thanks for pointing it out. We're doing our best to keep the tutorials up-to-date and will add this one to the list for sure. In the meantime... I did a quick comparison between the UI presented in this tutorial and the latest released version (3.5) and the only discrepancy I saw under "Defining the Kafka Producer" was "Data Format" which has been moved under its own tab. See below:

screen shot 2018-10-05 at 2 16 31 pm

Other than that, you should be able to follow along. If not, please let me know.

Cheers, Dash

iamontheinet avatar Oct 05 '18 21:10 iamontheinet

Thanks for the response. Unfortunately no help for me. Please refer to the screenshot below.

From this line onwards(Red) - i cannot do anything any further.

  • In the Avro tab leave the default as is.

Note: The Avro files already contain the schema that the origin will pick up and decode on the fly. If you'd like to override the default schema, enter the custom schema in the Avro tab. https://github.com/streamsets/tutorials/blob/master/tutorial-2/directory_to_kafkaproducer.md#defining-the-kafka-producerDefining the Kafka Producer

I have no idea why these kind of products exist at the first place which have a totally out of place documentation. If it is so much User interface driven product - it should have a perfect documentation. Or at the least the tutorial should specify which version to use and how to get that version?

It's a total waste of my time.

On Fri, Oct 5, 2018 at 4:19 PM Dash Desai [email protected] wrote:

Hi @ashutoshsharmaindia https://github.com/ashutoshsharmaindia,

Thanks for pointing it out. We're doing our best to keep the tutorials up-to-date and will add this one to the list for sure. In the meantime... I did a quick comparison between the UI presented in this tutorial and the latest released version (3.5) and the only discrepancy I saw under "Defining the Kafka Producer" was "Data Format" which has been moved to its own tab. See below:

[image: screen shot 2018-10-05 at 2 16 31 pm] https://user-images.githubusercontent.com/1723932/46560669-72737e80-c8a9-11e8-9a4f-97b0c7d0b92b.png

Other than that, you should be able to follow along. If not, please let me know.

Cheers, Dash

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/streamsets/tutorials/issues/96#issuecomment-427501898, or mute the thread https://github.com/notifications/unsubscribe-auth/AFctzpPBn_n4sEkMMsZKbtJ0dKxG4-Cnks5uh8z-gaJpZM4XK6Y8 .

-- With best Regards: Ashutosh Sharma

ashutoshsharmaindia avatar Oct 08 '18 03:10 ashutoshsharmaindia

yes, a total of waste time, because of the out-dated documents. I wish the docs are able to be updated, so that new version of SDC can work.

wiwengweng avatar Oct 17 '19 03:10 wiwengweng

@wiwengweng Where do you see the discrepancy? @iamontheinet updated the documentation over a year ago. I just checked the tutorial with the current version and it looks ok to me.

metadaddy avatar Nov 27 '19 21:11 metadaddy

@ashutoshsharmaindia I see no screenshot in your second comment

metadaddy avatar Nov 27 '19 21:11 metadaddy