It looks super cool :) On Mon, Dec 3, 2018 at 4:28 AM Karan Malhi <[email protected]> wrote:
> I will start taking a look at these this week. > > On Sun, Dec 2, 2018 at 4:07 AM David Blevins <[email protected]> > wrote: > > > > On Dec 1, 2018, at 5:41 PM, David Blevins <[email protected]> > > wrote: > > > > > > I'm attempting to get this to a point where we can crowd source some > > non-automatable tasks. > > [...] > > > To get there I just need to 1) minimally improve the index pages to > have > > groups and 2) add the jbake headers to all the files > > > > Ok, indexing is in and JBake headers added. > > > > - http://tomee.apache.org/tomee-8.0/docs/ > > - http://tomee.apache.org/tomee-8.0/examples/ > > > > Those preliminary groups are not anything near polished. Consider them > > inspiration, but restriction. Feel free dramatically change the groups. > > My intent is to do enough to show what can be done so others can be > > productive. > > > > > What I'm imaging we can all do in a divide and conquer fashion: > > > > > > - Categorize each document for an intelligent looking index > > > - Review each document for formatting issues > > > - Convert markdown documents to asciidoc > > > - Fix inconsistent h1, h2, h3 etc usage > > > - Update branding to "TomEE" from "OpenEJB" > > > - Ensure each has a title > > > - Check links > > > > Open season on docs. Let the PRs fly! What we need is people to dig in > > here and here: > > > > - https://github.com/apache/tomee/tree/master/docs > > - https://github.com/apache/tomee/tree/master/examples > > > > And create PRs like these commits: > > > > - > > > https://github.com/apache/tomee/commit/bdee81d34c60644b755621254a535d0d8757eb21 > > - > > > https://github.com/apache/tomee/commit/e2190a47c211c870680d761efd6d025d935546c7 > > > > While you're in there, make sure the document has a "title=Foo" > > > > I cannot stress enough the groupings you see do not reflect human action, > > so do not get fussed with questions like "Why didn't he group this one as > > CDI, it's clearly CDI???" I took an old index that was a bout 5 years > > stale and used it to seed the groups like so: > > > > - > > > https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/AddGroups.java > > > > So what you see a machine could do and did. We need humans to put some > > thought into the best way to organize and put groups in that make sense. > > > > If you'd like to build the docs locally, run this long command and then > > open your browser to http://localhost:8080 > > > > - git clone [email protected]:apache/tomee-site-generator.git && cd > > tomee-site-generator && mvn clean compile -Djbake.http=true > > > > That will clone the site repo and build it, which will in turn pull down > > all the related TomEE branches. > > > > > > -David > > > > > > -- > > Karan Singh Malhi >
