On the 0x255 day of Apache Harmony Alexey Varlamov wrote: > Nadya, all, > > I'm a bit late to reach this thread, but the work seems to be in > progress still - so here are my 2 cents: > Common: > - The (left) navigation pane is just right, no items to add or remove, > wording is good for me. > - Many pages now have annotations on top, I like them. > - Ubiquitous "Back to top" links should be formatted differently, > preferably in smaller font, otherwise they look confusingly similar to > informative links. > > Community/ > - "Get Involved" better be the first in the section, indeed. BTW, > need to fix the phrase on this page: "please provide a testcase and > instructions to help us duplicate the bug", "reproduce" is > conventional term. > - "Mailing lists" misses alerts@ list. > > Development/ > - "Getting started" should point to quickhelp_contributors.html > instead of quickhelp_users.html. People wishing to try Harmony would > rather go directly to "Downloads" than look for unpacking howtos in > development section, and for developers the quickhelp_users.html is > basically annoying dummy. The last need to be linked or inlined in > "downloads.html" only. > - One more thing about quickhelp_users.html, the leading paragraph > sounds too official and lawyer-ish: "The current document provides > basic instructions for people that wish to use Apache Harmony for > running their Java programs. The steps described below neither require > development tools nor necessitate compiling source code. The required > dependencies are listed below per platform. " And basically there is > no dependencies for ordinary users. > - svn.html suggests using HTTPS ever - I believe this is excessive, > just HTTP is fine for read-only needs of contributors. > - Content of Roadmap is fairly outdated. E.g. we already switched to > Java 5 ages ago, have a few tools available, integrated with Yoko and > j.u.concurrency, cleaned duplicated contributions, re-evaluated > porting matrix, created DRLVM TODO lists, etc. > - "Resolution Guideline" lists items in reverse order of importance IMO. > > Documentation/ > - Sitemap is nice, many thanks! But some links are named too > differently, e.g. "When an Issue Occurs" vs "Resolution Guideline", > this may be confusing. > Classlib links miss important VMI & portlib docs. I only managed to > dig out a broken reference in DRLVM kernel classes documents [1]. > > [1] Harmony Class Library Porting Documentation, > http://svn.apache.org/viewcvs.cgi/*checkout*/harmony/enhanced/classlib/trunk/doc/kernel_doc/html/index.html > > All in all, thumbs up for the good work! > > PS. Please don't listen to those provokations about imitating > httpd.apache.org, they just confuse soft with mild ;)
Alexey, where can I find the provocations? I did not come across any of them, just interested.. -- Egor Pasko
