From: Bruce Momjian <bruce@momjian.us>
To: Magnus Hagander <magnus@hagander.net>
Cc: Yuri Astrakhan <yuriastrakhan@gmail.com>
Cc: Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: Direct links to edit documentation
Date: Tue, 5 May 2020 10:49:55 -0400
Message-ID: <20200505144955.GB21185@momjian.us> (raw)
In-Reply-To: <CABUevEycm23fzeyLUNu9_2wQu2imgtsc_Qn8+rS2YsNXrWjrYA@mail.gmail.com>
References: <158817819740.669.5023892769438343392@wrigleys.postgresql.org>
<20200429172702.GA25843@momjian.us>
<CAJGfNe9C09SCeV5Euv9R=raz-t4mU5sU1nvt6CzUv5Q8vj2tKg@mail.gmail.com>
<CABUevEycm23fzeyLUNu9_2wQu2imgtsc_Qn8+rS2YsNXrWjrYA@mail.gmail.com>
On Mon, May 4, 2020 at 07:06:55PM +0200, Magnus Hagander wrote:
> I see how that can be pretty useful for something that's as simple as asciidoc.
> But I wonder how useful it would be for our docbook documentation.
>
> There'd be no preview (which there i sin the elastic), and we know how
> difficult it can be to get the tags right without running test builds even for
> those that are used to working in the system.
>
> Though if what we're considering are basically drive-by typo fixes and such,
> those would probably work in a scenario like that, since you're unlikely to
> need a preview or break a build.
>
> Another complication would be that we don't have a 1-1 mapping between source
> files and output URLs. So you'd have to find some way to track it back to the
> exactly right portion of the source file. This would probably be possible if we
> were to do it as a feature on our own site (and not just a
> source-edit-on-github-style), but it would probably ont be a trivial piece of
> work. Question is if the benefit would outweigh the cost, compared to just
> receiving comments and "manually patching them in".
All I can say is that most emails we get about the docs using the form
are just complaints, and we have to write some suggested text and get
approaval from the reporter that the text is clear. We don't get many
acutal _suggestions_.
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EnterpriseDB https://enterprisedb.com
+ As you are, so once was I. As I am, so you will be. +
+ Ancient Roman grave inscription +
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: bruce@momjian.us, magnus@hagander.net, yuriastrakhan@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Direct links to edit documentation
In-Reply-To: <20200505144955.GB21185@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox