+1 I like it Tyler!
On Thu, Aug 7, 2014 at 1:37 PM, Mattmann, Chris A (3980) < chris.a.mattm...@jpl.nasa.gov> wrote: > thanks Tyler, perfect > > ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ > Chris Mattmann, Ph.D. > Chief Architect > Instrument Software and Science Data Systems Section (398) > NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA > Office: 168-519, Mailstop: 168-527 > Email: chris.a.mattm...@nasa.gov > WWW: http://sunset.usc.edu/~mattmann/ > ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ > Adjunct Associate Professor, Computer Science Department > University of Southern California, Los Angeles, CA 90089 USA > ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ > > > > > > > -----Original Message----- > From: Tyler Palsulich <tpalsul...@gmail.com> > Reply-To: "dev@tika.apache.org" <dev@tika.apache.org> > Date: Thursday, August 7, 2014 2:33 PM > To: "dev@tika.apache.org" <dev@tika.apache.org> > Subject: Re: [DISCUSS] Give examples of Parser, Detector, and Translator > usage > > >Sounds like the new module is a good idea. So, let's jump on it! I will > >create a new 'example' JIRA tag and create issues for creating the module > >and adding Parse, Detect, and Translate examples. Others should add > >issues/desired examples as they see fit. How's that sound? > > > >Tyler > > > > > >On Thu, Aug 7, 2014 at 1:08 PM, Mattmann, Chris A (3980) < > >chris.a.mattm...@jpl.nasa.gov> wrote: > > > >> Great idea! This is what we did with apache OODT radix you can scope > >>here > >> https://cwiki.apache.org/confluence/display/OODT/RADiX+Powered+By+OODT > >> > >> Sent from my iPhone > >> > >> On Aug 7, 2014, at 12:56 PM, "Hong-Thai Nguyen" <thaicha...@gmail.com > >> <mailto:thaicha...@gmail.com>> wrote: > >> > >> Nice idea. > >> > >> We could do more than samples. We can generate parser, detecter or > >> translator maven archetype. A kind o templete so that user can have > >>quickly > >> project to develop new one. > >> > >> Regards, > >> > >> Hong-Thai > >> > >> On 07 Aug 2014, at 18:56, Tyler Palsulich <tpalsul...@apache.org > <mailto: > >> tpalsul...@apache.org>> wrote: > >> > >> Hi All, > >> > >> I think we should add some consolidated documentation on how to use > >>Tika's > >> Java API. It would be very helpful if we had short snippets of code that > >> showed how exactly you can use Parser.parse(), for example. I think I > >> remember a thread about testing example code a while back, but I'm not > >> sure. We have some developer documentation on the site, but the user > >>docs > >> are somewhat lacking. > >> > >> I can think of a few options: > >> > >> *1) tika-example module*. This module would have example code of using > >>each > >> main interface of Tika. Simplicity and organization would be king, so > >>new > >> users can find exactly what they're looking for quickly. A big benefit > >>of > >> this is that unit tests would be baked in. I like this option. One > >>downside > >> is that reading source code in the browser is terrible (e.g. see [0]). > >> > >> *2)* Examples section on the *wiki*. My impression is that the wiki is > >>not > >> as popular as the root website. And, it's also very easy to forget about > >> and let go out of date. But, formatting and explanations would be > >>pretty. > >> > >> *3)* Examples section on the *website*. This has the benefit of pretty > >> formatting and coloring, without the potential user having to check out > >>the > >> repo or view direct source in browser. Another benefit is this section > >> would be perfect for showing how to use the tika-app jar. > >> > >> Right now, I think the best option is a combination of 1 and 3. We get > >>some > >> end to end examples running in the tika-example module and short > >>snippets > >> of usage on an examples page of the website. > >> > >> What do you guys think? What other options should we consider? > >> > >> Tyler > >> > >> [0] - > >> > >> > >> > http://svn.apache.org/repos/asf/tika/trunk/tika-core/src/main/java/org/ap > >>ache/tika/parser/Parser.java > >> > > -- ------------------------------------------------------------------------------------------ Ann Bryant Burgess, PhD Postdoctoral Fellow Computer Science Department University of Southern California Viterbi School of Engineering Los Angeles, CA Alaska Science Center/USGS Anchorage, AK Cell: (585) 738-7549 Office: (907) 786-7059 Fax: (907) 786-7150 E-mail: anniebryant.burg...@gmail.com Office Address: 4210 University Dr., Anchorage, AK 99508-4626 -------------------------------------------------------------------------------------------