Re: Interactive Doc Comments - Their Future?

Поиск
Список
Период
Сортировка
От Magnus Hagander
Тема Re: Interactive Doc Comments - Their Future?
Дата
Msg-id CABUevEySZgGdTaKJz=DYoYYkPqhV2Pi4RAeY2vLTsAGV0me3Ug@mail.gmail.com
обсуждение исходный текст
Ответ на Re: Interactive Doc Comments - Their Future?  (Alvaro Herrera <alvherre@2ndquadrant.com>)
Ответы Re: Interactive Doc Comments - Their Future?
Список pgsql-www
On Thu, Mar 6, 2014 at 4:16 PM, Alvaro Herrera <alvherre@2ndquadrant.com> wrote:
Jonathan S. Katz wrote:
> On Mar 5, 2014, at 3:41 PM, Peter Eisentraut wrote:
>
> > On 3/5/14, 2:17 PM, Magnus Hagander wrote:
> >> Perhaps what we could do is replace them with something that works like
> >> the bug report form. So instead of submitting a comment into a static
> >> space, they turn into an email to the -docs list, which can then get
> >> discussion around it and eventually turn it into a modifications for the
> >> actual docs?
> >
> > That seems most useful to me.
>
> Yes, because ultimately, with a lot of doc comments that come in, this is what I would do anyway (and in fairness, I have queued up a bunch to send over)

So in short the "interactive" docs would go away (i.e. no comments are
displayed), and the form in the docs/interactive/ pages would submit a
comment to pgsql-docs, so that hopefully we merge the useful ones into
the main text.  The docs/interactive/ URLs would redirect to the static
pages (or perhaps serve the same contents without redirecting?)

Is that it?


Yes, that sums up my suggestion well.

I think the best is to redirect to static and actually add the form to the bottom of the static pages as well. There's no need to keep them separate if all we have is the feedback box, is there? (We could even use some javascript magic to hide it behind a click).

We'd want the redirects to happen rather than serve up the same content, for SEO reasons. 

--
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/

В списке pgsql-www по дате отправления:

Предыдущее
От: Alvaro Herrera
Дата:
Сообщение: Re: Interactive Doc Comments - Their Future?
Следующее
От: Bruce Momjian
Дата:
Сообщение: Re: Interactive Doc Comments - Their Future?