You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@arrow.apache.org by "amoeba (via GitHub)" <gi...@apache.org> on 2025/07/24 23:52:46 UTC

[I] Create high level documentation for Golang implentation [arrow-adbc]

amoeba opened a new issue, #3198:
URL: https://github.com/apache/arrow-adbc/issues/3198

   ### What feature or improvement would you like to see?
   
   The docs for the Golang implementation currently just link directly to the godoc site: https://pkg.go.dev/github.com/apache/arrow-adbc/go/adbc. This documentation is useful but doesn't contain much prose and might not be that useful for new users, especially those evaluating the package.
   
   Other implementations have higher level docs as part of the Sphinx docs with sections like,
   
   - Quickstart
   - Driver Manager
   - API Reference
   - Cookbooks
   
   And I think having a higher level set of docs for Golang would be good. In Golang's case, the API Reference could still link to the godoc site but the other sections would new new content.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@arrow.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [I] Create high level documentation for Golang implentation [arrow-adbc]

Posted by "amoeba (via GitHub)" <gi...@apache.org>.
amoeba commented on issue #3198:
URL: https://github.com/apache/arrow-adbc/issues/3198#issuecomment-3116325841

   PR up at https://github.com/apache/arrow-adbc/pull/3199.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [I] Create high level documentation for Golang implentation [arrow-adbc]

Posted by "amoeba (via GitHub)" <gi...@apache.org>.
amoeba commented on issue #3198:
URL: https://github.com/apache/arrow-adbc/issues/3198#issuecomment-3156363724

   We went with improving the Go pkgsite instead and just merged https://github.com/apache/arrow-adbc/pull/3204. Closing this as resolved.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [I] Create high level documentation for Golang implentation [arrow-adbc]

Posted by "amoeba (via GitHub)" <gi...@apache.org>.
amoeba commented on issue #3198:
URL: https://github.com/apache/arrow-adbc/issues/3198#issuecomment-3120063291

   @zeroshade suggested trying to improve the Go pkgsite instead, I took a shot at that in https://github.com/apache/arrow-adbc/pull/3204.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [I] Create high level documentation for Golang implentation [arrow-adbc]

Posted by "amoeba (via GitHub)" <gi...@apache.org>.
amoeba closed issue #3198: Create high level documentation for Golang implentation
URL: https://github.com/apache/arrow-adbc/issues/3198


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org