I agree Fred... the reports are very helpful. I've always thought of it as handling two needs: "reports" and "docs"; reports basically working OOTB and docs as the team decides to hand-create.
On Wed, Mar 18, 2015 at 10:43 PM, Fred Cooke <[email protected]> wrote: > Well, if you created it, then a personal thank you from me for that. I > would never use it for normal web stuff, but for the autogenerated stuff > like PMD, checkstyle, findbugs, cross ref code, javadocs, etc etc it's > GREAT at release time to give you a reference of what was. Or during dev, > when one feels like it, to create a comprehensive detailed view of the > state of the code that can be casually navigated through using a browser. > It has some SVNness in it, which I hate, so I invite you to continue the > hate for your own reasons :-D > > On Thu, Mar 19, 2015 at 4:32 PM, Jason van Zyl <[email protected]> wrote: > > > Anyone interested in trying a Jekyll experiment for our website? Extract > > the useful documentation we believe there is and try to make working on > the > > site a pleasurable experience that is easy for users to contribute to? > > > > I'd like to try this because after this last release I'm frankly tired of > > looking at our pretty awful website. It's ugly, noisy, unmaintained, hard > > to navigate and personally just makes me not want to write anything. I > > would like to like writing documentation again and I think a more > standard > > tool like Jekyll will help. I honestly dislike doing core releases > because > > I have to use the site plugin. I created it, I can hate it and I do hate > it. > > > > Even if no one answers I'll try this experiment because I think there's > > only 10-15 useful documents in the whole site so it likely won't take > long. > > > > Thanks, > > > > Jason > > > > ---------------------------------------------------------- > > Jason van Zyl > > Founder, Takari and Apache Maven > > http://twitter.com/jvanzyl > > http://twitter.com/takari_io > > --------------------------------------------------------- > > > > There's no sense in being precise when you don't even know what you're > > talking about. > > > > -- John von Neumann > > > > > > > > > > > > > > > > > > > > > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [email protected] > > For additional commands, e-mail: [email protected] > > > > >
