Re: Direct links to edit documentation

2020-05-06 Thread Magnus Hagander
On Tue, May 5, 2020 at 4:49 PM Bruce Momjian wrote: > 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

Re: Direct links to edit documentation

2020-05-05 Thread Bruce Momjian
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 > di

Re: Direct links to edit documentation

2020-05-04 Thread Yuri Astrakhan
(accidentally sent my last post without the links at the bottom, fixed) Daniel and Magnus, thanks for your replies. Here's my personal 2-click submission "ideal scenario", that may differ from other contributors, but seems to be very common now for many FOSS projects. I think this will work for

Re: Direct links to edit documentation

2020-05-04 Thread Yuri Astrakhan
Daniel and Magnus, thanks for your replies. Here's my personal 2-click submission "ideal scenario", that may differ from other contributors, but seems to be very common now for many FOSS projects. I think this will work for the vast majority of the documentation pages. Note that this is not a wi

Re: Direct links to edit documentation

2020-05-04 Thread Daniel Gustafsson
> On 4 May 2020, at 19:06, Magnus Hagander wrote: > Question is if the benefit would outweigh the cost, compared to just receiving > comments and "manually patching them in". Another question is the cost of managing access to such a system, we haven't exactly had the best of luck with input from

Re: Direct links to edit documentation

2020-05-04 Thread Magnus Hagander
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 t

Re: Direct links to edit documentation

2020-04-29 Thread Yuri Astrakhan
ElasticSearch also uses AsciiDoc with the "edit_me" module that generates those. Code - https://github.com/elastic/docs/blob/master/resources/asciidoctor/lib/edit_me/extension.rb It results in a semi-transparent "edit me" button at the top to the right of the page title, e.g. https://www.elastic.

Re: Direct links to edit documentation

2020-04-29 Thread Bruce Momjian
On Wed, Apr 29, 2020 at 04:36:37PM +, PG Doc comments form wrote: > The following documentation comment has been logged on the website: > > Page: https://www.postgresql.org/docs/12/runtime-config-wal.html > Description: > > Would it be possible to add "edit this page" links to every PostgreSQ

Direct links to edit documentation

2020-04-29 Thread PG Doc comments form
The following documentation comment has been logged on the website: Page: https://www.postgresql.org/docs/12/runtime-config-wal.html Description: Would it be possible to add "edit this page" links to every PostgreSQL doc page, pointing to the docs git repo, ideally on a site that allows on-the-si