Re: Comments in docs

2012-05-04 Thread André Malo
On Friday 04 May 2012 11:48:01 Daniel Gruno wrote: > On 04-05-2012 11:39, André Malo wrote: > >> Yes, I added a test for "$is-chm or $is-zip or $metafile/basename = > >> 'index'" so it would only add the comments for our online version and > >> only for non-index pages. And if I managed to screw th

Re: Comments in docs

2012-05-04 Thread Daniel Gruno
On 04-05-2012 11:39, André Malo wrote: >> Yes, I added a test for "$is-chm or $is-zip or $metafile/basename = >> 'index'" so it would only add the comments for our online version and >> only for non-index pages. And if I managed to screw that up, I'm hoping >> you'll lend a hand at fixing it :) >

Re: Comments in docs

2012-05-04 Thread André Malo
> Yes, I added a test for "$is-chm or $is-zip or $metafile/basename = > 'index'" so it would only add the comments for our online version and > only for non-index pages. And if I managed to screw that up, I'm hoping > you'll lend a hand at fixing it :) ;-) That's not enough, unfortuantely. The pr

Re: Comments in docs

2012-05-04 Thread Igor Galić
- Original Message - > On Thursday 03 May 2012 21:55:02 Daniel Gruno wrote: > > On 03-05-2012 19:07, Igor Galić wrote: > > > I'm pretty and sure that the disqus offers these things as well. > > > And while I know that it's not the Apache Way, because, it wasn't > > > invented here, I'm pr

Re: Comments in docs

2012-05-04 Thread Daniel Gruno
On 04-05-2012 10:55, André Malo wrote: > > Another side note: > > We need to build a different version for online vs. shipped after integrating > comments. I don't think it's reasonable to burden the locally installed docs > with external references. > > nd > > ---

Re: Comments in docs

2012-05-04 Thread André Malo
On Thursday 03 May 2012 21:55:02 Daniel Gruno wrote: > On 03-05-2012 19:07, Igor Galić wrote: > > I'm pretty and sure that the disqus offers these things as well. > > And while I know that it's not the Apache Way, because, it wasn't > > invented here, I'm pretty sure it's a good idea to experiment

Re: Comments in docs

2012-05-04 Thread Daniel Gruno
On 04-05-2012 02:13, Kyle Hamilton wrote: > > On Thu, May 3, 2012 at 1:17 PM, Rich Bowen wrote: >> >>> >>> Is it possible to integrate different languages? (And how do we moderate >>> those?) >>> >> >> I expect people can post in any language. We can then use google >> translate >> to moderate th

Re: Comments in docs

2012-05-03 Thread Rich Bowen
On May 3, 2012, at 8:13 PM, Kyle Hamilton wrote: > > On Thu, May 3, 2012 at 1:17 PM, Rich Bowen wrote: >> >>> >>> Is it possible to integrate different languages? (And how do we moderate >>> those?) >>> >> >> I expect people can post in any language. We can then use google translate >> to m

Re: Comments in docs

2012-05-03 Thread Kyle Hamilton
On Thu, May 3, 2012 at 1:17 PM, Rich Bowen wrote: Is it possible to integrate different languages? (And how do we moderate those?) I expect people can post in any language. We can then use google translate to moderate them. That usually works well enough to understand the intent. The be

Re: Comments in docs

2012-05-03 Thread Rich Bowen
> > Is it possible to integrate different languages? (And how do we moderate > those?) > I expect people can post in any language. We can then use google translate to moderate them. That usually works well enough to understand the intent.

Re: Comments in docs

2012-05-03 Thread Daniel Gruno
On 03-05-2012 22:06, André Malo wrote: > > Is it possible to integrate different languages? (And how do we moderate > those?) > > nd Yes, from what I have read about the embedded stuff so far, we can make it distinguish between the various languages through the xslt by, for example with the Fr

Re: Comments in docs

2012-05-03 Thread André Malo
* Daniel Gruno wrote: > On 03-05-2012 19:07, Igor Galić wrote: > > I'm pretty and sure that the disqus offers these things as well. > > And while I know that it's not the Apache Way, because, it wasn't > > invented here, I'm pretty sure it's a good idea to experiment with > > something that alread

Re: Comments in docs

2012-05-03 Thread Daniel Gruno
On 03-05-2012 19:07, Igor Galić wrote: > I'm pretty and sure that the disqus offers these things as well. > And while I know that it's not the Apache Way, because, it wasn't > invented here, I'm pretty sure it's a good idea to experiment with > something that already exists, because we invent and

Re: Comments in docs

2012-05-03 Thread Igor Galić
- Original Message - > On 03-05-2012 18:28, Igor Galić wrote: > > > >>> How does PHP documentation deal with the problem of spam? > >> > > [snip] > >> "What is five minus one". But they also moderate the comments as > >> they come in, which is a thankless job. I think that it's > >> worth

Re: Comments in docs

2012-05-03 Thread Daniel Gruno
On 03-05-2012 18:28, Igor Galić wrote: > >>> How does PHP documentation deal with the problem of spam? >> > [snip] >> "What is five minus one". But they also moderate the comments as >> they come in, which is a thankless job. I think that it's >> worthwhile, but will require some folks volunteerin

Re: Comments in docs

2012-05-03 Thread Igor Galić
> > How does PHP documentation deal with the problem of spam? > [snip] > "What is five minus one". But they also moderate the comments as > they come in, which is a thankless job. I think that it's > worthwhile, but will require some folks volunteering to staff this. > I volunteer. hmmm… just lik

Re: Comments in docs

2012-05-03 Thread Rich Bowen
On May 3, 2012, at 12:06 PM, Igor Galić wrote: > Please remember that there's an option to moderate > comments. I'd send new comments to docs@ for review/approval. > I don't know the exact workings of this, but if it's a > link to approve that would be not so good. With docs@ > being a public ML

Re: Comments in docs

2012-05-03 Thread Rich Bowen
On May 3, 2012, at 12:08 PM, Nick Kew wrote: >> >> I've long been a fan of the PHP documentation - specifically, the way that >> they solicit commentary from readers, and then fold that commentary into the >> docs. Not only did it encourage me to comment on the docs, it also got me >> involve

Re: Comments in docs

2012-05-03 Thread Igor Galić
- Original Message - > > On 3 May 2012, at 14:54, Rich Bowen wrote: > > > I've long been a fan of the PHP documentation - specifically, the > > way that they solicit commentary from readers, and then fold that > > commentary into the docs. Not only did it encourage me to comment > > on th

Re: Comments in docs

2012-05-03 Thread Nick Kew
On 3 May 2012, at 14:54, Rich Bowen wrote: > I've long been a fan of the PHP documentation - specifically, the way that > they solicit commentary from readers, and then fold that commentary into the > docs. Not only did it encourage me to comment on the docs, it also got me > involved in the P

Re: Comments in docs

2012-05-03 Thread Igor Galić
- Original Message - > On 03-05-2012 15:54, Rich Bowen wrote: > > Does anyone know of a way to integrate a third-party comment > > service > > like, say, disqus or whatnot, into our docs, so that we could get > > direct > > feedback from our audience? Or can you think of another way that

Re: Comments in docs

2012-05-03 Thread Daniel Gruno
On 03-05-2012 15:54, Rich Bowen wrote: > Does anyone know of a way to integrate a third-party comment service > like, say, disqus or whatnot, into our docs, so that we could get direct > feedback from our audience? Or can you think of another way that we > might do this? > I like the general idea

Comments in docs

2012-05-03 Thread Rich Bowen
I've long been a fan of the PHP documentation - specifically, the way that they solicit commentary from readers, and then fold that commentary into the docs. Not only did it encourage me to comment on the docs, it also got me involved in the PHP documentation project, at least marginally. The ba