----------------------------------------------------------- This is an automatically generated e-mail. To reply, visit: https://reviews.apache.org/r/50154/#review143777 -----------------------------------------------------------
I think it will be simpler if we can just provide architectural overview in the website and add a separate tutorial to run it with samza-hello-samza. Thanks! docs/learn/documentation/versioned/rest/overview.md (line 71) <https://reviews.apache.org/r/50154/#comment209700> Avoid using /export/content/ or any absolute path. It will be useful to describe what this location should point to. docs/learn/documentation/versioned/rest/overview.md (line 83) <https://reviews.apache.org/r/50154/#comment209705> Table is missing description for job.proxy.factory.class , job.installations.path docs/learn/documentation/versioned/rest/overview.md (line 102) <https://reviews.apache.org/r/50154/#comment209756> Since this document serves as both overview and tutorial, can you please add more documentation on how to run the service? Perhaps some curl commands and sample output will be useful. I was able to install samza-rest on my box. But I don't know what I should be doing beyond that. - Navina Ramesh On July 27, 2016, 8:47 p.m., Jake Maes wrote: > > ----------------------------------------------------------- > This is an automatically generated e-mail. To reply, visit: > https://reviews.apache.org/r/50154/ > ----------------------------------------------------------- > > (Updated July 27, 2016, 8:47 p.m.) > > > Review request for samza, Boris Shkolnik, Chris Pettitt, Jake Maes, Navina > Ramesh, Jagadish Venkatraman, Xinyu Liu, and Yi Pan (Data Infrastructure). > > > Bugs: SAMZA-976 > https://issues.apache.org/jira/browse/SAMZA-976 > > > Repository: samza > > > Description > ------- > > SAMZA-976 Samza REST Documentation > > > Diffs > ----- > > bin/generate-javadocs.sh da9f32da8f2a1f89ff28178ee703c4a065189da8 > docs/img/versioned/learn/documentation/rest/JobsResource.png PRE-CREATION > docs/learn/documentation/versioned/index.html > 1e79bd6f39ee67b5a2b74222d647342990bbbe23 > docs/learn/documentation/versioned/rest/monitors.md PRE-CREATION > docs/learn/documentation/versioned/rest/overview.md PRE-CREATION > docs/learn/documentation/versioned/rest/resource-directory.md PRE-CREATION > docs/learn/documentation/versioned/rest/resources.md PRE-CREATION > docs/learn/documentation/versioned/rest/resources/jobs.md PRE-CREATION > > Diff: https://reviews.apache.org/r/50154/diff/ > > > Testing > ------- > > Verified by building the local site documentation and browsing. I wasn't able > to verify the javadoc. If anyone knows why java doc would not be generated > for new classes, I'd be interested to know. > > > Thanks, > > Jake Maes > >