I'd say you underestimate the benefits of Confluence. Confluence wiki is familiar to multiple people and I very much doubt we'd get any documentation contributions from the non-developers with an esoteric, homegrown CMS or git. We can temporarily move to a different Confluence instance if Apache forces to move away from it, but I doubt they actually do that for existing projects so I agree with with Bob, there's no reason to change until we have to.
Kalle On Mon, Dec 26, 2011 at 2:14 PM, Howard Lewis Ship <[email protected]> wrote: > I'd love to use something a bit more offline, like Jekyl > (https://github.com/mojombo/jekyll) to generate the documentation. > > The only advantage to our current approach is that we have a half-way > ground, where signers of the CLA can contribute documentation. > > What about if we maintain a public Git repo for the documentation, and > only accept pull requests from people who have signed the CLA? > > On Mon, Dec 26, 2011 at 1:44 PM, Bob Harner <[email protected]> wrote: >> I don't know. My gut feeling is that it will take several months to migrate >> our content, something we should start thinking about in the coming months >> but not something to start doing quite yet. Remember, just because the >> infrastructure guys say something will happen by a certain deadline doesn't >> mean it really will. A lot can change in a year. >> >> I'll admit I'm reluctant to move quickly to a new homegrown CMS system >> designed from scratch by a system administrator, built on Perl, written in >> just 30 days and only in use a couple of months now. I'd rather let some >> other projects work out the kinks. >> >> Bob Harner >> On Dec 26, 2011 2:19 PM, "Josh Canfield" <[email protected]> wrote: >> >>> The comments on your defect seem too imply that we only have confluence for >>> a year. What happens after a year? How long is it going to take to migrate? >>> On Dec 26, 2011 6:43 AM, "Bob Harner" <[email protected]> wrote: >>> >>> > Yeah, but I wouldn't be in a rush. Better to let other projects work out >>> > the bugs, and maybe they'll even come up with a migration path that we >>> can >>> > use. Right now we have a very nice system that works well. >>> > >>> > Bob Harner >>> > On Dec 25, 2011 6:58 PM, "Josh Canfield" <[email protected]> wrote: >>> > >>> > > It sounds like there needs to be an effort to get off confluence if we >>> > > really only have "a year max". >>> > > On Dec 24, 2011 8:18 AM, "Bob Harner" <[email protected]> wrote: >>> > > >>> > > > Howard (or anybody else with Confluence admin rights), >>> > > > >>> > > > Can you paste the template in one more time? I've updated the >>> > > > template in SVN again, with a work-around. >>> > > > >>> > > > >>> > > /tapestry/tapestry-site/branches/post-5.2-site/autoexport_template.txt >>> > > > >>> > > > The Apache infrastructure guys marked as "invalid" the INFRA-4248 >>> JIRA >>> > > > issue I filed (no surprise there), So now I've gone in another >>> > > > direction, forcing IE into standards mode using the "x-ua-compatible" >>> > > > meta tag. (For the curious, see >>> > > > http://www.alistapart.com/articles/beyonddoctype) >>> > > > >>> > > > Thanks in advance! >>> > > > >>> > > > On Thu, Dec 22, 2011 at 3:23 PM, Bob Harner <[email protected]> >>> > wrote: >>> > > > > Unfortunately, the IE problem persists. The DOCTYPE declaration is >>> > > > > still not being rendered as the first item in the HTML. >>> > > > > >>> > > > > I checked several other Apache web sites -- Shiro, Directory, >>> Camel, >>> > > > > ActiveMQ -- which also use the auto-export process, and they also >>> all >>> > > > > render in Quirks mode in IE due to having the DOCTYPE in the wrong >>> > > > > place, even though their auto-export templates >>> > > > > (e.g. >>> > > > >>> > > >>> > >>> http://shiro.apache.org/confluence-auto-export.data/shiroConfluenceAutoExportTemplate.vhtml.txt >>> > > > ) >>> > > > > are correct. So I guess this problem is caused by the export plugin >>> > > > > itself. Maybe the Apache infrastructure guys are forcing the >>> license >>> > > > > to the top for bureaucratic reasons. >>> > > > > >>> > > > > Unless somebody has another idea, I'll file a ticket with the >>> Apache >>> > > > > Infrastructure team. I don't think they really want to support the >>> > > > > auto-export plugin, though. >>> > > > > >>> > > > > Alternatively, we could change the site design to work well in >>> Quirks >>> > > > > mode. But I'd really rather not do that. >>> > > > > >>> > > > > On Thu, Dec 22, 2011 at 12:21 PM, Howard Lewis Ship < >>> > [email protected]> >>> > > > wrote: >>> > > > >> Updated, export in progress. >>> > > > >> >>> > > > >> On Wed, Dec 21, 2011 at 5:52 PM, Bob Harner <[email protected]> >>> > > > wrote: >>> > > > >>> The problem is that the export process is causing the DOCTYPE >>> > > > >>> declaration to appear below the license comment block, despite >>> the >>> > > > >>> template having it the other way around. It turns out that not >>> > having >>> > > > >>> the DOCTYPE declaration as the very first thing on the page >>> causes >>> > IE >>> > > > >>> to remain in quirks mode. >>> > > > >>> >>> > > > >>> I updated the file in SVN again, moving the velocity directives >>> > below >>> > > > >>> the DOCTYPE declaration. Can you (or anyone) try pasting it into >>> > the >>> > > > >>> admin console again, making sure that <!DOCTYPE html> is the very >>> > > > >>> first line in the resulting text? (Or if you want, give me the >>> site >>> > > > >>> admin rights to do so myself.) >>> > > > >>> >>> > > > >>> Then I'll just publish a single page so we can see if it is right >>> > > > >>> before exporting the whole site again. >>> > > > >>> >>> > > > >>> Thanks! >>> > > > >>> >>> > > > >>> On Tue, Dec 20, 2011 at 2:48 PM, Bob Harner <[email protected] >>> > >>> > > > wrote: >>> > > > >>>> Thanks! >>> > > > >>>> >>> > > > >>>> Unfortunately, the new DOCTYPE didn't seem to help, even though >>> my >>> > > > >>>> tests showed that it would. My IE 8 is still rendering the page >>> in >>> > > > >>>> Quirks mode. More investigation needed... >>> > > > >>>> >>> > > > >>>> On Tue, Dec 20, 2011 at 11:23 AM, Howard Lewis Ship < >>> > > [email protected]> >>> > > > wrote: >>> > > > >>>>> Export is in progress, now. >>> > > > >>>>> >>> > > > >>>>> On Tue, Dec 20, 2011 at 8:20 AM, Howard Lewis Ship < >>> > > [email protected]> >>> > > > wrote: >>> > > > >>>>>> On it! >>> > > > >>>>>> >>> > > > >>>>>> On Fri, Dec 16, 2011 at 2:55 PM, Bob Harner < >>> > [email protected]> >>> > > > wrote: >>> > > > >>>>>>> For many many months now, our nice Confluence-generated >>> > > > documentation >>> > > > >>>>>>> has not looked right in IE, due to IE rendering in quirks >>> mode. >>> > > The >>> > > > >>>>>>> simple fix is to switch to a proper doctype, such as the >>> HTML5 >>> > > > one, in >>> > > > >>>>>>> the auto-export template. I have done that today and >>> committed >>> > > the >>> > > > >>>>>>> change, but somebody with Confluence admin rights (such as >>> Uli) >>> > > > will >>> > > > >>>>>>> need to paste the contents of the newly-committed template >>> > > > >>>>>>> >>> > > > >>> > (/tapestry/tapestry-site/branches/post-5.2-site/autoexport_template.txt) >>> > > > >>>>>>> into the admin screens as described at the bottom of >>> > > > >>>>>>> http://tapestry.apache.org/confluence-site-setup.html >>> > > > >>>>>>> >>> > > > >>>>>>> Once that is done and the whole site re-exported, IE will >>> like >>> > > > >>>>>>> Tapestry once again. >>> > > > >>>>>>> >>> > > > >>>>>>> Thanks in advance to whoever takes care of this! >>> > > > >>>>>>> >>> > > > >>>>>>> >>> > > > --------------------------------------------------------------------- >>> > > > >>>>>>> To unsubscribe, e-mail: [email protected] >>> > > > >>>>>>> For additional commands, e-mail: >>> [email protected] >>> > > > >>>>>>> >>> > > > >>>>>> >>> > > > >>>>>> >>> > > > >>>>>> >>> > > > >>>>>> -- >>> > > > >>>>>> Howard M. Lewis Ship >>> > > > >>>>>> >>> > > > >>>>>> Creator of Apache Tapestry >>> > > > >>>>>> >>> > > > >>>>>> The source for Tapestry training, mentoring and support. >>> Contact >>> > > me >>> > > > to >>> > > > >>>>>> learn how I can get you up and productive in Tapestry fast! >>> > > > >>>>>> >>> > > > >>>>>> (971) 678-5210 >>> > > > >>>>>> http://howardlewisship.com >>> > > > >>>>> >>> > > > >>>>> >>> > > > >>>>> >>> > > > >>>>> -- >>> > > > >>>>> Howard M. Lewis Ship >>> > > > >>>>> >>> > > > >>>>> Creator of Apache Tapestry >>> > > > >>>>> >>> > > > >>>>> The source for Tapestry training, mentoring and support. >>> Contact >>> > me >>> > > > to >>> > > > >>>>> learn how I can get you up and productive in Tapestry fast! >>> > > > >>>>> >>> > > > >>>>> (971) 678-5210 >>> > > > >>>>> http://howardlewisship.com >>> > > > >>>>> >>> > > > >>>>> >>> > > --------------------------------------------------------------------- >>> > > > >>>>> To unsubscribe, e-mail: [email protected] >>> > > > >>>>> For additional commands, e-mail: [email protected] >>> > > > >>>>> >>> > > > >>> >>> > > > >>> >>> > --------------------------------------------------------------------- >>> > > > >>> To unsubscribe, e-mail: [email protected] >>> > > > >>> For additional commands, e-mail: [email protected] >>> > > > >>> >>> > > > >> >>> > > > >> >>> > > > >> >>> > > > >> -- >>> > > > >> Howard M. Lewis Ship >>> > > > >> >>> > > > >> Creator of Apache Tapestry >>> > > > >> >>> > > > >> The source for Tapestry training, mentoring and support. Contact >>> me >>> > to >>> > > > >> learn how I can get you up and productive in Tapestry fast! >>> > > > >> >>> > > > >> (971) 678-5210 >>> > > > >> http://howardlewisship.com >>> > > > >> >>> > > > >> >>> > --------------------------------------------------------------------- >>> > > > >> To unsubscribe, e-mail: [email protected] >>> > > > >> For additional commands, e-mail: [email protected] >>> > > > >> >>> > > > >>> > > > --------------------------------------------------------------------- >>> > > > To unsubscribe, e-mail: [email protected] >>> > > > For additional commands, e-mail: [email protected] >>> > > > >>> > > > >>> > > >>> > >>> > > > > -- > Howard M. Lewis Ship > > Creator of Apache Tapestry > > The source for Tapestry training, mentoring and support. Contact me to > learn how I can get you up and productive in Tapestry fast! > > (971) 678-5210 > http://howardlewisship.com > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
