Re: Syntax diagrams in user documentation

From: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
To: Jeremy Schneider <schnjere(at)amazon(dot)com>, Peter Geoghegan <pg(at)bowt(dot)ie>, Jürgen Purtz <juergen(at)purtz(dot)de>
Cc: PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Syntax diagrams in user documentation
Date: 2019-03-29 08:25:23
Message-ID: a6d02b09-a628-94e6-ebdf-9dcd1dd0878b@2ndquadrant.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 2019-03-28 23:45, Jeremy Schneider wrote:
> We're just gearing up for the Google Season of Docs and I think this
> would be a great task for a doc writer to help with. Any reason to
> expect serious objections to syntax diagram graphics in the docs?

It's worth a thought, but I tend to think that this would not be a good
task for a "technical writer". It's either an automation task or
busywork transcribing the syntax to whatever new intermediate format.

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Jamison, Kirk 2019-03-29 08:34:38 RE: Timeout parameters
Previous Message Kyotaro HORIGUCHI 2019-03-29 08:24:40 Re: Protect syscache from bloating with negative cache entries