streamnative / pulsar-client-go

Apache Pulsar Go Client Library
https://pulsar.apache.org/
Apache License 2.0
1 stars 2 forks source link

ISSUE-652: Fix Godoc #236

Open sijie opened 3 years ago

sijie commented 3 years ago

Original Issue: apache/pulsar-client-go#652


The godoc throughout much of the project is incorrect, leading to IDEs such as VsCode not showing documentation unless the comment (accidentally?) starts with the correct identifier name. For example, when I'm creating a consumer, I can't see anything about what the different fields in pulsar.ConsumerOptions. For example, Topic shows nothing: image because the godoc at the definition (which is very useful), does not start with the string Topic: image

Whereas pulsar.Shared does: image Because the comment happens to begin with the string Shared image