On Tue, Oct 25, 2016 at 10:27 PM Anthony Baker <aba...@pivotal.io> wrote:
> What I’m taking from this thread is that: > > 1) We (the Geode project) need to rework the README now that we have maven > artifacts available. > I'm not sure the relationship. There's two issues I see with the current docs. 1. They're pointing to Pivotal, meaning you need to go to a vendor to understand how to use Geode. While I understand this was a late donation from Pivotal, it should be treated as a priority to use ASF docs. 2. They're pointing to client libraries from that same vendor. The project should provide OOTB self maintained libraries for developers to leverage the tool, without the use of a third party. I'll point out that one of your mentors has suggested that this project is really close to graduation... based on what I'm seeing (and to explain - this isn't a random drive by, I'm looking at alternate persistence stores for ActiveMQ Artemis), this project still has very close ties to a vendor and unless it can separate that I'm not sure it can graduate. > 2) We need to more prominently point users to the geode-examples/ source. > Yes. > 3) We need more examples. > Yes. > 4) We should include the examples with the binary (convenience) release > artifacts. > Meh. I don't personally think that's useful, but others may have other opinions. > > Sounds like something to tackle for the next release! > > Anthony > > > On Oct 24, 2016, at 9:13 PM, John Blum <jb...@pivotal.io> wrote: > > > On Mon, Oct 24, 2016 at 5:59 PM, John D. Ament <johndam...@apache.org> > > wrote: > > > > > Hi, > > > > > > Reading through the geode docs, it seems like there's a key piece > missing > > > - how do I actually connect as a client? > > > > > > If I look here > http://geode.incubator.apache.org/docs/guide/developing/ > > > book_intro.html, I don't see anything obvious - e.g. what maven > > > coordinates to use to get a reference, or what to download. Seems > like I > > > need to build from source. > > > > > > If I look at https://github.com/apache/incubator-geode/blob/develop/ > > > > README.md , I get a bit more worrisome (especially as an IPMC member). > > > > The client section links me to 3 pivotal websites and one cwiki > entry. If > > > I want just a plain java client, no real information available (in > fact, > > > the Java client line isn't a link). > > > > > > So, how do I begin as a java client? And at what point does geode > update > > > their links for internal docs? For the record, the pivotal docs up > first > > > in searches > > > > > > John > > >
