[
https://issues.apache.org/jira/browse/CALCITE-1369?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15467786#comment-15467786
]
Julian Hyde commented on CALCITE-1369:
--------------------------------------
I'm not a huge fan of wikis. To keep the information coherent and up to date, I
believe that someone who understands the site structure needs to organize (and
periodically re-organize) content. This is achieved by a site authored in
markdown, a pull request mechanism, and a committer to take the contribution
and if necessary clean it up a bit.
Anyone who wants to contribute content can make a pull request on the web site,
https://github.com/apache/calcite/tree/master/avatica/site. In this case, I
think a section needs to be added to the [main doc
page|http://calcite.apache.org/avatica/docs], which corresponds to
https://github.com/apache/calcite/blob/master/avatica/site/_docs/index.md.
Github allows you to edit pages in-place then create a pull request.
> Display a list of Avatica clients on the website
> ------------------------------------------------
>
> Key: CALCITE-1369
> URL: https://issues.apache.org/jira/browse/CALCITE-1369
> Project: Calcite
> Issue Type: Improvement
> Components: avatica
> Reporter: Francis Chuang
> Priority: Minor
>
> I think it would be really neat to have a well organized list of Avatica
> clients on the website. This would make clients much more discoverable and
> make Avatica and Calcite much more easier for people to get started with. For
> example, Kafka has a wiki page with their clients here:
> https://cwiki.apache.org/confluence/display/KAFKA/Clients
> 1. Most of the clients currently available (the .NET and python ones) are
> currently targeted towards Apache Phoenix. Should we include these clients?
> If not, is there a process for reaching out to their maintainers to see if
> they are interested in generalising them to target Avatica?
> 2. Is there any process for including a client on such a page? Should anyone
> be able to add the client, or do we need explicit permission from the
> maintainers?
> 3. To reduce friction, is it viable to have a wiki page, so that maintainers
> can easily add their own clients?
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
