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]
