Le 5 sept. 2016 21:20, "David Blevins" <david.blev...@gmail.com> a écrit : > > Looking great! > > I’d definitely be “pro” grouping.
Was thinking to a convention on sample names for that (split on -?) > > Note on the Wall of fame, I think it’d be great to list everyone. Maybe two sections “Most Recent” and “All time”. > First impl used github a bit like example page but data were not that accurate and rendering suffered from it so used a manual list thinking comitters and contributors can PR themself ( see https://github.com/rmannibucau/site-tomee-ng/blob/master/src/main/jbake/content/community/contributors.adoc ) > -- > David Blevins > http://twitter.com/dblevins > http://www.tomitribe.com > > > On Sep 2, 2016, at 10:18 AM, Romain Manni-Bucau <rmannibu...@gmail.com> wrote: > > > > added a basic example section: > > http://tomee.apache.org/ng/examples/index.html > > > > feel free to hack anything you want there like tagging or whatever but > > basic feature is there; Idea was to provide a search box instead of > > organizing the example to let them be browsable more efficiently. Doesn't > > prevent to organize them later but we need to find a convention then (page > > is generated) > > > > > > Romain Manni-Bucau > > @rmannibucau <https://twitter.com/rmannibucau> | Blog > > <https://blog-rmannibucau.rhcloud.com> | Old Wordpress Blog > > <http://rmannibucau.wordpress.com> | Github < https://github.com/rmannibucau> | > > LinkedIn <https://www.linkedin.com/in/rmannibucau> | Tomitriber > > <http://www.tomitribe.com> | JavaEE Factory > > <https://javaeefactory-rmannibucau.rhcloud.com> > > > > 2016-04-12 7:47 GMT+02:00 Romain Manni-Bucau <rmannibu...@gmail.com>: > > > >> Hi Chris > >> > >> Le 12 avr. 2016 02:33, "Chris Owens" <ctag+open...@chris-owens.com> a > >> écrit : > >>> > >>> Speaking as a reasonably-well-informed user of TomEE, who has been into > >> the > >>> code, but who is still very much an outsider, I would say that > >> documentation > >>> is probably the biggest obstacle to wider uptake. It's a project I would > >> be > >>> happy to work on. I'm willing to put the work in to do some serious > >> writing. > >>> > >>> Before we talk about documentation workflow, git vs other models, CMSes, > >>> etc., I think there are some much more basic questions to address: > >>> > >>> -- Who is the intended audience for each major portion of the > >> documentation? > >>> > >> > >> I d say people not able to go to code and in that category 2 > >> subcategories: admin and dev. > >> > >>> -- For TomEE Components that are not owned by this project (e.g., Tomcat, > >>> cxf, JMS, etc.), how shall our documentation interact with that > >> component's > >>> "native" documentation? By reference? By duplication? Other? > >>> > >> > >> Reference + enrichment when needed. Really against duplication. > >> > >>> -- What are the major reference topics that need to be covered? (For > >>> example, Contexts, Classloaders, Configuration, Testing, Embedded, etc)? > >>> > >> > >> Idea was to start with some basics and add info depending the list > >> questions. > >> > >>> -- What are the major tutorial or "how-to" threads that need to be > >> covered? > >>> > >>> > >> > >> Same there. Should also probably consider rework very hard examples to > >> make them useful and more explicit (arquillian website is a great example > >> there). > >> > >>> > >>> > >>> > >>> -- > >>> View this message in context: http://tomee-openejb.979440. > >> n4.nabble.com/reworking-the-website-tp4677918p4678116.html > >>> Sent from the TomEE Dev mailing list archive at Nabble.com. > >> >
