PS - cause it appeared unobvious on jira: we should try to keep current bookmarks as much as possible cause users already complained we changed them and it is now "done" (= we dont get complains anymore or very rarely) so i don't feel comfortable breaking it again
Romain Manni-Bucau @rmannibucau <https://twitter.com/rmannibucau> | Blog <https://blog-rmannibucau.rhcloud.com> | Old Blog <http://rmannibucau.wordpress.com> | Github <https://github.com/rmannibucau> | LinkedIn <https://www.linkedin.com/in/rmannibucau> | JavaEE Factory <https://javaeefactory-rmannibucau.rhcloud.com> 2017-06-26 12:48 GMT+02:00 Ivan Junckes Filho <[email protected]>: > Thanks Romain will work on this. > > On Mon, Jun 26, 2017 at 7:45 AM, Romain Manni-Bucau <[email protected] > > > wrote: > > > 2017-06-26 12:43 GMT+02:00 Ivan Junckes Filho <[email protected]>: > > > > > Hi guys, if you agree with Thomas menu I can try to work on the change > > and > > > make the "sub-menus" like sections in the page so sub-menus wouldn't be > > > necessary. > > > > > > What do you think Romain? > > > > > > > sub menus are needed to ensure the navigation is smooth and not enforced > > some pages (reduce the number of *clicks* ;) - hover is fine). > > > > +1 to modify the menu while it works on desktop and mobile. > > > > > > > > > > > > > > > > On Mon, Jun 26, 2017 at 7:42 AM, Ivan Junckes Filho < > > [email protected] > > > > > > > wrote: > > > > > > > > > > > > > > > On Mon, Jun 26, 2017 at 2:16 AM, Romain Manni-Bucau < > > > [email protected] > > > > > wrote: > > > > > > > >> Hmm, interesting. Reworking the website I ensured to avoid JavaEE > (BTW > > > JEE > > > >> doesnt exist anymore ;)) cause it is not important at tomee level. I > > > mean > > > >> if tomee covers JavaEE then it reduces mathematically tomee specific > > > >> features space which is what users search coming on tomee website in > > > >> general. > > > >> > > > >> The classloader point is funny but part of the most hit issue so > don't > > > >> know > > > >> if hiding it a bit would be beneficial. The website has been thought > > as > > > an > > > >> enabler/reference and less like a book with a progression ('getting > > > >> started"s probably) which is more or less what you propose. Wonder > if > > we > > > >> can merge both somehow, probably with the new menu item. > > > >> > > > >> I like your menu but it can need a submenu on doc - not sure how > > mobile > > > >> handling would be but doable. > > > >> > > > >> Maybe we should drop the blog, we never used it accurately. > > > >> > > > >> > > > >> Romain Manni-Bucau > > > >> @rmannibucau <https://twitter.com/rmannibucau> | Blog > > > >> <https://blog-rmannibucau.rhcloud.com> | Old Blog > > > >> <http://rmannibucau.wordpress.com> | Github < > > > >> https://github.com/rmannibucau> | > > > >> LinkedIn <https://www.linkedin.com/in/rmannibucau> | JavaEE Factory > > > >> <https://javaeefactory-rmannibucau.rhcloud.com> > > > >> > > > >> 2017-06-26 0:40 GMT+02:00 Thomas Whitmore > <twhitmore@bravurasolutions. > > > com > > > >> >: > > > >> > > > >> > Hi Ivan, Romain, > > > >> > > > > >> > I probably support having a 'Documentation' item in the top menu. > > At > > > >> the > > > >> > moment there are all the subtopics, but nothing at the top-level > > says > > > >> > Documentation! At a brief glance this is likely to give the > > > impression > > > >> > that there isn't documentation, or that it's hard to find. > > > >> > > > > >> > From an external perspective 'Documentation', 'Getting Started' > and > > > >> > possibly 'Examples' are good top-level headings. > > > >> > > > > >> > I would suggest something like: > > > >> > - Documentation > > > >> > - Getting Starting > > > >> > - Examples > > > >> > - Blog > > > >> > - Community > > > >> > - Downloads > > > >> > > > > >> > I write quite a lot of documentation so my quick thoughts -- > trying > > to > > > >> be > > > >> > constructive here. > > > >> > > > > >> > Reviewing the current 'Developer', 'Admin', 'Advanced' pages -- > > these > > > >> are > > > >> > all lacking any overview to tell you the basics and badly empty. > > > >> > There needs to be some introductory text to start these sections > and > > > set > > > >> > the scene, TomEE for Developers needs to start with an overview > of > > > what > > > >> > TomEE is & why it's good; then have some simple guide or guides > to > > > >> writing > > > >> > JEE application, as the first (few) articles. These will show how > to > > > use > > > >> > TomEE's features. > > > >> > > > > >> > 'Developer' section should go something like: > > > >> > - (introductory text) TomEE is a JEE container. Advantages this > > > gives. > > > >> > - JEE Basics -- basic outlines of how to write a JEE application > & > > > link > > > >> > to other guides > > > >> > - Eclipse, Intellij Idea, Netbeans: TomEE in and IDE (maybe: > but > > > >> > there's no real content here) > > > >> > - JEE Feature Guides > > > >> > - TomEE and Testing > > > >> > > > > >> > Perhaps there could be several guides to important JEE areas: > > > >> > - JEE Guide -- CDI > > > >> > - JEE Guide -- Datasource > > > >> > - JEE Guide -- JPA > > > >> > - JEE Guide -- EJB > > > >> > - JEE Guide -- CXF & Webservices > > > >> > > > > >> > The above topics map well to the areas in Examples > > > >> > http://tomee.apache.org/examples/index-ng.html which have good > > > coverage > > > >> > of examples.. and outlining a little bit of concrete usage should > > > allow > > > >> > good opportunities to explain TomEE's configuration, particular > > > details > > > >> etc. > > > >> > > > > >> > (Little bit of an insight here -- perhaps the fact that we haven't > > > been > > > >> > focusing / docing based on the JEE features, has made it hard to > > write > > > >> doc?) > > > >> > > > > >> > I suggest 'Developer' section should not start with "All you need > to > > > >> know > > > >> > about TomEE classloading". This is not what new developer should > > need > > > to > > > >> > get started with, and is a great way to scare people off. > > > >> > > > > >> > Busy these past couple of months, trying to offer some guidance to > > the > > > >> > best degree I can but don't have time available to actually do the > > > >> writing. > > > >> > > > > >> > > > > >> > Regards, > > > >> > Thomas > > > >> > > > > >> > ____________________________________________________________ > > > __________ > > > >> > This email has been scanned by the Symantec Email Security.cloud > > > >> service. > > > >> > For more information please visit http://www.symanteccloud.com > > > >> > ____________________________________________________________ > > > __________ > > > >> > > > > >> > > > > > > > > > > > > > >
