pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedLegal Notice page in 10 not "backwards compatible" in online docs
6+ messages / 3 participants
[nested] [flat]
* Legal Notice page in 10 not "backwards compatible" in online docs
@ 2017-05-19 12:07 Daniel Gustafsson <daniel@yesql.se>
0 siblings, 1 reply; 6+ messages in thread
From: Daniel Gustafsson @ 2017-05-19 12:07 UTC (permalink / raw)
To: pgsql-docs
The Legal Notice page has in 10 changed from being uppercased to lowercased,
and in the process the site no longer sees it as being present in previous
version of the documentation:
https://www.postgresql.org/docs/9.6/static/LEGALNOTICE.html
https://www.postgresql.org/docs/10/static/legalnotice.html
The 9.6 page lists "This page in other versions:” from 7.4 to 9.6 while the 10
version of the same page (albeit with minor stylistic changes) is only listed
as being present in 10 and devel. Not sure if the case change is what caused
that to happen though, it was just what caught my attention (looking at the
code I was not able to quickly find the cause).
While not the most critical issue, consistency with earlier versions would be a
good thing as the page does exist there.
cheers ./daniel
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Legal Notice page in 10 not "backwards compatible" in online docs
@ 2017-05-19 21:43 Alvaro Herrera <alvherre@2ndquadrant.com>
parent: Daniel Gustafsson <daniel@yesql.se>
0 siblings, 1 reply; 6+ messages in thread
From: Alvaro Herrera @ 2017-05-19 21:43 UTC (permalink / raw)
To: Daniel Gustafsson <daniel@yesql.se>; +Cc: pgsql-docs
Daniel Gustafsson wrote:
> The Legal Notice page has in 10 changed from being uppercased to lowercased,
> and in the process the site no longer sees it as being present in previous
> version of the documentation:
>
> https://www.postgresql.org/docs/9.6/static/LEGALNOTICE.html
> https://www.postgresql.org/docs/10/static/legalnotice.html
>
> The 9.6 page lists "This page in other versions:” from 7.4 to 9.6 while the 10
> version of the same page (albeit with minor stylistic changes) is only listed
> as being present in 10 and devel. Not sure if the case change is what caused
> that to happen though, it was just what caught my attention (looking at the
> code I was not able to quickly find the cause).
>
> While not the most critical issue, consistency with earlier versions would be a
> good thing as the page does exist there.
I think this is worth fixing -- perhaps not because the "legal notice"
page itself is terribly important to carry forward, but rather because a
fix would presumably also fix the pg_xlogdump -> pg_waldump ones, which
have the same problem and from a user's point of view are more critical.
--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Legal Notice page in 10 not "backwards compatible" in online docs
@ 2017-05-25 14:14 Magnus Hagander <magnus@hagander.net>
parent: Alvaro Herrera <alvherre@2ndquadrant.com>
0 siblings, 1 reply; 6+ messages in thread
From: Magnus Hagander @ 2017-05-25 14:14 UTC (permalink / raw)
To: Alvaro Herrera <alvherre@2ndquadrant.com>; +Cc: Daniel Gustafsson <daniel@yesql.se>; pgsql-docs
On Fri, May 19, 2017 at 5:43 PM, Alvaro Herrera <alvherre@2ndquadrant.com>
wrote:
> Daniel Gustafsson wrote:
> > The Legal Notice page has in 10 changed from being uppercased to
> lowercased,
> > and in the process the site no longer sees it as being present in
> previous
> > version of the documentation:
> >
> > https://www.postgresql.org/docs/9.6/static/LEGALNOTICE.html
> > https://www.postgresql.org/docs/10/static/legalnotice.html
> >
> > The 9.6 page lists "This page in other versions:” from 7.4 to 9.6 while
> the 10
> > version of the same page (albeit with minor stylistic changes) is only
> listed
> > as being present in 10 and devel. Not sure if the case change is what
> caused
> > that to happen though, it was just what caught my attention (looking at
> the
> > code I was not able to quickly find the cause).
> >
> > While not the most critical issue, consistency with earlier versions
> would be a
> > good thing as the page does exist there.
>
> I think this is worth fixing -- perhaps not because the "legal notice"
> page itself is terribly important to carry forward, but rather because a
> fix would presumably also fix the pg_xlogdump -> pg_waldump ones, which
> have the same problem and from a user's point of view are more critical.
>
Those are really two different things.
The easiest way to fix the one that Daniel reported would be to just make
it have the same name as before, wouldn't it? That would also automatically
fix any other cases that would possibly link to LEGALNOTICE. (AFAIK this is
the only file that was caps before)
--
Magnus Hagander
Me: https://www.hagander.net/ <http://www.hagander.net/;
Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/;
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Legal Notice page in 10 not "backwards compatible" in online docs
@ 2017-05-25 15:44 Magnus Hagander <magnus@hagander.net>
parent: Magnus Hagander <magnus@hagander.net>
0 siblings, 2 replies; 6+ messages in thread
From: Magnus Hagander @ 2017-05-25 15:44 UTC (permalink / raw)
To: Alvaro Herrera <alvherre@2ndquadrant.com>; +Cc: Daniel Gustafsson <daniel@yesql.se>; pgsql-docs
On Thu, May 25, 2017 at 10:14 AM, Magnus Hagander <magnus@hagander.net>
wrote:
> On Fri, May 19, 2017 at 5:43 PM, Alvaro Herrera <alvherre@2ndquadrant.com>
> wrote:
>
>> Daniel Gustafsson wrote:
>> > The Legal Notice page has in 10 changed from being uppercased to
>> lowercased,
>> > and in the process the site no longer sees it as being present in
>> previous
>> > version of the documentation:
>> >
>> > https://www.postgresql.org/docs/9.6/static/LEGALNOTICE.html
>> > https://www.postgresql.org/docs/10/static/legalnotice.html
>> >
>> > The 9.6 page lists "This page in other versions:” from 7.4 to 9.6 while
>> the 10
>> > version of the same page (albeit with minor stylistic changes) is only
>> listed
>> > as being present in 10 and devel. Not sure if the case change is what
>> caused
>> > that to happen though, it was just what caught my attention (looking at
>> the
>> > code I was not able to quickly find the cause).
>> >
>> > While not the most critical issue, consistency with earlier versions
>> would be a
>> > good thing as the page does exist there.
>>
>> I think this is worth fixing -- perhaps not because the "legal notice"
>> page itself is terribly important to carry forward, but rather because a
>> fix would presumably also fix the pg_xlogdump -> pg_waldump ones, which
>> have the same problem and from a user's point of view are more critical.
>>
>
> Those are really two different things.
>
> The easiest way to fix the one that Daniel reported would be to just make
> it have the same name as before, wouldn't it? That would also automatically
> fix any other cases that would possibly link to LEGALNOTICE. (AFAIK this is
> the only file that was caps before)
>
>
Turns out that adding the capability to do aliases was a lot easier than I
thought :) I've added an alias for legalnotice and also for pg_receivewal,
pg_resetwal and pg_waldump so far.
Do we have some more docs pages where we need to do that?
--
Magnus Hagander
Me: https://www.hagander.net/ <http://www.hagander.net/;
Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/;
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Legal Notice page in 10 not "backwards compatible" in online docs
@ 2017-05-25 17:01 Alvaro Herrera <alvherre@2ndquadrant.com>
parent: Magnus Hagander <magnus@hagander.net>
1 sibling, 0 replies; 6+ messages in thread
From: Alvaro Herrera @ 2017-05-25 17:01 UTC (permalink / raw)
To: Magnus Hagander <magnus@hagander.net>; +Cc: Daniel Gustafsson <daniel@yesql.se>; pgsql-docs
Magnus Hagander wrote:
> > The easiest way to fix the one that Daniel reported would be to just make
> > it have the same name as before, wouldn't it? That would also automatically
> > fix any other cases that would possibly link to LEGALNOTICE. (AFAIK this is
> > the only file that was caps before)
>
> Turns out that adding the capability to do aliases was a lot easier than I
> thought :) I've added an alias for legalnotice and also for pg_receivewal,
> pg_resetwal and pg_waldump so far.
Yay! :-)
--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Legal Notice page in 10 not "backwards compatible" in online docs
@ 2017-05-25 19:00 Daniel Gustafsson <daniel@yesql.se>
parent: Magnus Hagander <magnus@hagander.net>
1 sibling, 0 replies; 6+ messages in thread
From: Daniel Gustafsson @ 2017-05-25 19:00 UTC (permalink / raw)
To: Magnus Hagander <magnus@hagander.net>; +Cc: Alvaro Herrera <alvherre@2ndquadrant.com>; pgsql-docs
> On 25 May 2017, at 17:44, Magnus Hagander <magnus@hagander.net> wrote:
>
> Turns out that adding the capability to do aliases was a lot easier than I thought :) I've added an alias for legalnotice and also for pg_receivewal, pg_resetwal and pg_waldump so far.
Awesome!
> Do we have some more docs pages where we need to do that?
A quick scan through the docs didn’t turn up any others, will report if I spot any more.
cheers ./daniel
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 6+ messages in thread
end of thread, other threads:[~2017-05-25 19:00 UTC | newest]
Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2017-05-19 12:07 Legal Notice page in 10 not "backwards compatible" in online docs Daniel Gustafsson <daniel@yesql.se>
2017-05-19 21:43 ` Alvaro Herrera <alvherre@2ndquadrant.com>
2017-05-25 14:14 ` Magnus Hagander <magnus@hagander.net>
2017-05-25 15:44 ` Magnus Hagander <magnus@hagander.net>
2017-05-25 17:01 ` Alvaro Herrera <alvherre@2ndquadrant.com>
2017-05-25 19:00 ` Daniel Gustafsson <daniel@yesql.se>
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