+1 to post it user@ list. The users are the real consumers of the website and their feedback is really important.
On Thu, Jul 6, 2017 at 9:38 AM, Jonathan Gallimore < [email protected]> wrote: > Hi Ivan! > > Thanks for the links. My personal view - I prefer the documentation link, > but I do like the split of the documentation page into groups. The > advantage here as I see it is all the documentation is linked in one place > - no need to go into 'Developer' and realize its not there, and then check > 'Admin'. > > I also wonder if we should also post this to the users@ list to see if > there are any preferences there? > > I understand Romain's points about the 404 (see the PR comments) - a > potential compromise there is for the admin and developer links to forward > onto the documentation page with a note saying its moved and "please update > your bookmarks". We'll inevitably want to move content around and/or change > the structure over time. Some sort of graceful way of doing that like I > described might be good pattern to follow. > > Thanks for taking the time to hack on this and present it to the community! > > Jon > > On Thu, Jul 6, 2017 at 1:30 PM, Ivan Junckes Filho <[email protected]> > wrote: > > > (Please disregard the previous email, pressed enter by mistake) > > > > Hi guys, thank you for the feedback on this. The intention of the > > "Documentation" was to let the user know exactly where what he is looking > > for is. The content inside is not perfect, but we are getting better. > > > > The links for the changes made are below, please give feedback on them. > > > > Pull Request: > > https://github.com/apache/tomee-site-generator/pull/1 > > > > Website for review: > > https://ivanjunckes.github.io/ > > > > Thank you. > > > > > > On Thu, Jul 6, 2017 at 9:27 AM, Ivan Junckes Filho < > [email protected]> > > wrote: > > > > > Hi guys, thank you for the feedback on this. The intention of the > > > "Documentation" was to let the user know exactly where what he is > looking > > > for is. The content inside is not perfect, but we are getting better. > > > > > > Here are all the changes made > > > > > > > > > On Wed, Jul 5, 2017 at 7:51 PM, Romain Manni-Bucau < > > [email protected]> > > > wrote: > > > > > >> Ok, saw Andy did a similar comment on github so probably let's reverse > > the > > >> question. > > >> > > >> Anyone feeling like me it is a passthrough? (if not under 1 day think > we > > >> can "close it" and just push it in prod) > > >> > > >> > > >> 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-07-06 0:48 GMT+02:00 Thomas Whitmore <twhitmore@bravurasolutions. > > com > > >> >: > > >> > > >> > For me the Documentation menu item is very good; it shows at the > top > > >> > level that the TomEE project has documentation. > > >> > Also like the content of the Documentation page, it hits 'How to > > >> > Configure', 'IDEs' and 'Testing' upfront & early which should give > a > > >> good > > >> > impression on people considering uptake of the project -- as well as > > not > > >> > looking so terribly empty. > > >> > > > >> > +1 on both fronts. > > >> > > > >> > Search can be an additional feature but for me getting the static > text > > >> > structure OK is paramount. I think Ivan has made very good > improvement > > >> on > > >> > that. > > >> > > > >> > > > >> > -----Original Message----- > > >> > From: Romain Manni-Bucau [mailto:[email protected]] > > >> > Sent: Thursday, 6 July 2017 9:09 AM > > >> > To: [email protected] > > >> > Subject: Re: Site and "documentation" usage > > >> > > > >> > very close http://people.apache.org/~rmannibucau/ivan/ can be used > > >> (think > > >> > Ivan did some minor adjustments after but overall idea is here if > I'm > > >> not > > >> > mistaken) > > >> > > > >> > > > >> > 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-07-05 23:03 GMT+02:00 Jonathan Gallimore < > > >> > [email protected]> > > >> > : > > >> > > > >> > > Ivan - did you have some luck getting that staged somewhere? I'd > > love > > >> > > to take a look and give some feedback. > > >> > > > > >> > > Cheers > > >> > > > > >> > > Jon > > >> > > > >> > ____________________________________________________________ > > __________ > > >> > This email has been scanned by the Symantec Email Security.cloud > > >> service. > > >> > For more information please visit http://www.symanteccloud.com > > >> > ____________________________________________________________ > > __________ > > >> > > > >> > > > > > > > > > -- Daniel Cunha https://twitter.com/dvlc_
