Looks good overall - thanks a lot for the improvements. Couple of comments: clicking on the 0.7 link goes to the migration page (which should probably be on the 0.8 link) Also, for the configuration.html file, I used to find the old scala docs pointing to the actual *Config classes more current and informative. The site can drift over time.
Joel On Fri, Jun 28, 2013 at 2:49 PM, Sriram Subramanian <srsubraman...@linkedin.com> wrote: > > > On 6/28/13 2:48 PM, "Sriram Subramanian" <srsubraman...@linkedin.com> > wrote: > >>1. I have moved the FAQ to a wiki. I have separated the sections into >>producer, consumers and broker related questions. I would still need to >>add replication FAQ. The main FAQ will now link to this. Let me know if >>you guys have better ways of representing the FAQ. >> >>https://cwiki.apache.org/confluence/display/KAFKA/FAQ >> >> >>2. I yanked the implementation part of the design doc and added it as a >>separate section for 0.7. We need to add similar section for 0.8. >> >>3. I also made the migration link directly point to the wiki. It might >>also make sense to convert the wiki to an html page. >> >> >> >>On 6/27/13 7:17 PM, "Sriram Subramanian" <srsubraman...@linkedin.com> >>wrote: >> >>>Looks much better. >>> >>>1. We need to update FAQ for 0.8 >>>2. We should probably have a separate section for implementation. >>>3. The migration tool explanation seems to be hard to get to. >>> >>> >>> >>>On 6/27/13 5:40 PM, "Jay Kreps" <jay.kr...@gmail.com> wrote: >>> >>>>Hey Folks, >>>> >>>>I did a pass on the website. Changes: >>>>1. Rewrote the 0.8 quickstart and included a section on running in >>>>distributed mode. >>>>2. Fixed up the styles a bit. >>>>3. Fixed the bizarre menu thing with 0.7 and 0.8 specific docs. >>>>4. Re-wrote the copy on the front page. >>>> >>>>I would love to get any feedback on how we could improve the site, >>>>documentation, etc. >>>> >>>>I would like to do at least the following: >>>>1. Generate scaladoc just for the client classes. >>>>2. See if there isn't some way to generate javadoc for the java api >>>>3. Rewrite the design document for 0.8 >>>>4. Update the operations guide to cover 0.8 >>>> >>>>-Jay >>> >> >
