[Geoserver-devel] Documentation not updating, yet doc build seems fine

Hi,
the documentation does not seem to be updating anymore, at least for the “latest” link.

For example, see this raw link to github, talking about a new ability in the wps download process (community module):
https://github.com/geoserver/geoserver/blob/master/doc/en/user/source/community/wps-download/rawDownload.rst#writing-parameters

and the documentation published on site (two links to try here):

http://docs.geoserver.org/latest/en/user/community/wps-download/rawDownload.html

http://docs.geoserver.org/master/en/user/community/wps-download/rawDownload.html

I went on the build server to have a look, the documentation build is there, running, and seems to be
doing its job, too:
https://build.geoserver.org/view/geoserver/job/geoserver-master-live-docs/1082/console

The change above is 8 days old, the last live docs build is 2 days old, I’ve checked the revision number it’s
getting, it was up to date, run the same build command on my machine and that generates up to date
documentation.

The copying steps at the end also seem right. So… how come the file comes back outdated on
the doc site?

Wondering if by any chance there is a caching accelerator in the middle that is not seeing file updates?

Cheers
Andrea

···

GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information.

Ing. Andrea Aime
@geowolf
Technical Lead

GeoSolutions S.A.S.
Via di Montramito 3/A
55054 Massarosa (LU)
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 339 8844549

http://www.geo-solutions.it
http://twitter.com/geosolutions_it

AVVERTENZE AI SENSI DEL D.Lgs. 196/2003

Le informazioni contenute in questo messaggio di posta elettronica e/o nel/i file/s allegato/i sono da considerarsi strettamente riservate. Il loro utilizzo è consentito esclusivamente al destinatario del messaggio, per le finalità indicate nel messaggio stesso. Qualora riceviate questo messaggio senza esserne il destinatario, Vi preghiamo cortesemente di darcene notizia via e-mail e di procedere alla distruzione del messaggio stesso, cancellandolo dal Vostro sistema. Conservare il messaggio stesso, divulgarlo anche in parte, distribuirlo ad altri soggetti, copiarlo, od utilizzarlo per finalità diverse, costituisce comportamento contrario ai principi dettati dal D.Lgs. 196/2003.

The information in this message and/or attachments, is intended solely for the attention and use of the named addressee(s) and may be confidential or proprietary in nature or covered by the provisions of privacy act (Legislative Decree June, 30 2003, no.196 - Italy’s New Data Protection Code).Any use not in accord with its purpose, any disclosure, reproduction, copying, distribution, or either dissemination, either whole or partial, is strictly forbidden except previous formal approval of the named addressee(s). If you are not the intended recipient, please contact immediately the sender by telephone, fax or e-mail and delete the information in this message that has been received in error. The sender does not give any warranty or accept liability as the content, accuracy or completeness of sent messages and accepts no responsibility for changes made after they were sent or for other risks which arise as a result of e-mail transmission, viruses, etc.

This mail was probably not delivered due to the SF mailing list outage, trying again:

···

GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information.

Ing. Andrea Aime
@geowolf
Technical Lead

GeoSolutions S.A.S.
Via di Montramito 3/A
55054 Massarosa (LU)
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 339 8844549

http://www.geo-solutions.it
http://twitter.com/geosolutions_it

AVVERTENZE AI SENSI DEL D.Lgs. 196/2003

Le informazioni contenute in questo messaggio di posta elettronica e/o nel/i file/s allegato/i sono da considerarsi strettamente riservate. Il loro utilizzo è consentito esclusivamente al destinatario del messaggio, per le finalità indicate nel messaggio stesso. Qualora riceviate questo messaggio senza esserne il destinatario, Vi preghiamo cortesemente di darcene notizia via e-mail e di procedere alla distruzione del messaggio stesso, cancellandolo dal Vostro sistema. Conservare il messaggio stesso, divulgarlo anche in parte, distribuirlo ad altri soggetti, copiarlo, od utilizzarlo per finalità diverse, costituisce comportamento contrario ai principi dettati dal D.Lgs. 196/2003.

The information in this message and/or attachments, is intended solely for the attention and use of the named addressee(s) and may be confidential or proprietary in nature or covered by the provisions of privacy act (Legislative Decree June, 30 2003, no.196 - Italy’s New Data Protection Code).Any use not in accord with its purpose, any disclosure, reproduction, copying, distribution, or either dissemination, either whole or partial, is strictly forbidden except previous formal approval of the named addressee(s). If you are not the intended recipient, please contact immediately the sender by telephone, fax or e-mail and delete the information in this message that has been received in error. The sender does not give any warranty or accept liability as the content, accuracy or completeness of sent messages and accepts no responsibility for changes made after they were sent or for other risks which arise as a result of e-mail transmission, viruses, etc.

So, I see the new content on the stable (2.13) docs: http://docs.geoserver.org/stable/en/user/community/wps-download/rawDownload.html#writing-params

Latest ought to be on 2.14 now, but that seems to not be the case. I’ll dig into jenkins and see if I can figure out whats going on.

Torben

···

On Thu, Feb 22, 2018 at 1:43 AM, Andrea Aime <andrea.aime@anonymised.com> wrote:

This mail was probably not delivered due to the SF mailing list outage, trying again:

---------- Forwarded message ----------
From: Andrea Aime <andrea.aime@anonymised.com…>
Date: Wed, Feb 14, 2018 at 7:18 PM
Subject: Documentation not updating, yet doc build seems fine
To: Geoserver-devel <geoserver-devel@anonymised.comsourceforge.net>

Hi,
the documentation does not seem to be updating anymore, at least for the “latest” link.

For example, see this raw link to github, talking about a new ability in the wps download process (community module):
https://github.com/geoserver/geoserver/blob/master/doc/en/user/source/community/wps-download/rawDownload.rst#writing-parameters

and the documentation published on site (two links to try here):

http://docs.geoserver.org/latest/en/user/community/wps-download/rawDownload.html

http://docs.geoserver.org/master/en/user/community/wps-download/rawDownload.html

I went on the build server to have a look, the documentation build is there, running, and seems to be
doing its job, too:
https://build.geoserver.org/view/geoserver/job/geoserver-master-live-docs/1082/console

The change above is 8 days old, the last live docs build is 2 days old, I’ve checked the revision number it’s
getting, it was up to date, run the same build command on my machine and that generates up to date
documentation.

The copying steps at the end also seem right. So… how come the file comes back outdated on
the doc site?

Wondering if by any chance there is a caching accelerator in the middle that is not seeing file updates?

Cheers
Andrea

==

GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information.

Ing. Andrea Aime
@geowolf
Technical Lead

GeoSolutions S.A.S.
Via di Montramito 3/A
55054 Massarosa (LU)
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 339 8844549

http://www.geo-solutions.it
http://twitter.com/geosolutions_it

AVVERTENZE AI SENSI DEL D.Lgs. 196/2003

Le informazioni contenute in questo messaggio di posta elettronica e/o nel/i file/s allegato/i sono da considerarsi strettamente riservate. Il loro utilizzo è consentito esclusivamente al destinatario del messaggio, per le finalità indicate nel messaggio stesso. Qualora riceviate questo messaggio senza esserne il destinatario, Vi preghiamo cortesemente di darcene notizia via e-mail e di procedere alla distruzione del messaggio stesso, cancellandolo dal Vostro sistema. Conservare il messaggio stesso, divulgarlo anche in parte, distribuirlo ad altri soggetti, copiarlo, od utilizzarlo per finalità diverse, costituisce comportamento contrario ai principi dettati dal D.Lgs. 196/2003.

The information in this message and/or attachments, is intended solely for the attention and use of the named addressee(s) and may be confidential or proprietary in nature or covered by the provisions of privacy act (Legislative Decree June, 30 2003, no.196 - Italy’s New Data Protection Code).Any use not in accord with its purpose, any disclosure, reproduction, copying, distribution, or either dissemination, either whole or partial, is strictly forbidden except previous formal approval of the named addressee(s). If you are not the intended recipient, please contact immediately the sender by telephone, fax or e-mail and delete the information in this message that has been received in error. The sender does not give any warranty or accept liability as the content, accuracy or completeness of sent messages and accepts no responsibility for changes made after they were sent or for other risks which arise as a result of e-mail transmission, viruses, etc.


Check out the vibrant tech community on one of the world’s most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot


Geoserver-devel mailing list
Geoserver-devel@anonymised.com.366…sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

Okay, should be fixed. Turns out the doc builds were all sharing the same workspace (hidden under “Advanced” configuration) for no good reason and stomping over each other. Surprised worse issues didn’t show up (the main issue was structural conflicts between the pre-2.12 build and the post-2.12 build, leading to things winding up in the wrong folders).

Torben

···

On Fri, Feb 23, 2018 at 9:09 AM, Torben Barsballe <tbarsballe@anonymised.com> wrote:

So, I see the new content on the stable (2.13) docs: http://docs.geoserver.org/stable/en/user/community/wps-download/rawDownload.html#writing-params

Latest ought to be on 2.14 now, but that seems to not be the case. I’ll dig into jenkins and see if I can figure out whats going on.

Torben

On Thu, Feb 22, 2018 at 1:43 AM, Andrea Aime <andrea.aime@anonymised.com> wrote:

This mail was probably not delivered due to the SF mailing list outage, trying again:

---------- Forwarded message ----------
From: Andrea Aime <andrea.aime@anonymised.com>
Date: Wed, Feb 14, 2018 at 7:18 PM
Subject: Documentation not updating, yet doc build seems fine
To: Geoserver-devel <geoserver-devel@anonymised.com…orge.net>

Hi,
the documentation does not seem to be updating anymore, at least for the “latest” link.

For example, see this raw link to github, talking about a new ability in the wps download process (community module):
https://github.com/geoserver/geoserver/blob/master/doc/en/user/source/community/wps-download/rawDownload.rst#writing-parameters

and the documentation published on site (two links to try here):

http://docs.geoserver.org/latest/en/user/community/wps-download/rawDownload.html

http://docs.geoserver.org/master/en/user/community/wps-download/rawDownload.html

I went on the build server to have a look, the documentation build is there, running, and seems to be
doing its job, too:
https://build.geoserver.org/view/geoserver/job/geoserver-master-live-docs/1082/console

The change above is 8 days old, the last live docs build is 2 days old, I’ve checked the revision number it’s
getting, it was up to date, run the same build command on my machine and that generates up to date
documentation.

The copying steps at the end also seem right. So… how come the file comes back outdated on
the doc site?

Wondering if by any chance there is a caching accelerator in the middle that is not seeing file updates?

Cheers
Andrea

==

GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information.

Ing. Andrea Aime
@geowolf
Technical Lead

GeoSolutions S.A.S.
Via di Montramito 3/A
55054 Massarosa (LU)
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 339 8844549

http://www.geo-solutions.it
http://twitter.com/geosolutions_it

AVVERTENZE AI SENSI DEL D.Lgs. 196/2003

Le informazioni contenute in questo messaggio di posta elettronica e/o nel/i file/s allegato/i sono da considerarsi strettamente riservate. Il loro utilizzo è consentito esclusivamente al destinatario del messaggio, per le finalità indicate nel messaggio stesso. Qualora riceviate questo messaggio senza esserne il destinatario, Vi preghiamo cortesemente di darcene notizia via e-mail e di procedere alla distruzione del messaggio stesso, cancellandolo dal Vostro sistema. Conservare il messaggio stesso, divulgarlo anche in parte, distribuirlo ad altri soggetti, copiarlo, od utilizzarlo per finalità diverse, costituisce comportamento contrario ai principi dettati dal D.Lgs. 196/2003.

The information in this message and/or attachments, is intended solely for the attention and use of the named addressee(s) and may be confidential or proprietary in nature or covered by the provisions of privacy act (Legislative Decree June, 30 2003, no.196 - Italy’s New Data Protection Code).Any use not in accord with its purpose, any disclosure, reproduction, copying, distribution, or either dissemination, either whole or partial, is strictly forbidden except previous formal approval of the named addressee(s). If you are not the intended recipient, please contact immediately the sender by telephone, fax or e-mail and delete the information in this message that has been received in error. The sender does not give any warranty or accept liability as the content, accuracy or completeness of sent messages and accepts no responsibility for changes made after they were sent or for other risks which arise as a result of e-mail transmission, viruses, etc.


Check out the vibrant tech community on one of the world’s most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot


Geoserver-devel mailing list
Geoserver-devel@anonymised.comrge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

Ha, good investigation, thanks a lot for solving!

Cheers
Andrea

···

On Fri, Feb 23, 2018 at 6:45 PM, Torben Barsballe <tbarsballe@anonymised.com> wrote:

Okay, should be fixed. Turns out the doc builds were all sharing the same workspace (hidden under “Advanced” configuration) for no good reason and stomping over each other. Surprised worse issues didn’t show up (the main issue was structural conflicts between the pre-2.12 build and the post-2.12 build, leading to things winding up in the wrong folders).

Torben

On Fri, Feb 23, 2018 at 9:09 AM, Torben Barsballe <tbarsballe@anonymised.com…> wrote:

So, I see the new content on the stable (2.13) docs: http://docs.geoserver.org/stable/en/user/community/wps-download/rawDownload.html#writing-params

Latest ought to be on 2.14 now, but that seems to not be the case. I’ll dig into jenkins and see if I can figure out whats going on.

Torben

On Thu, Feb 22, 2018 at 1:43 AM, Andrea Aime <andrea.aime@anonymised.com> wrote:

This mail was probably not delivered due to the SF mailing list outage, trying again:

---------- Forwarded message ----------
From: Andrea Aime <andrea.aime@anonymised.com>
Date: Wed, Feb 14, 2018 at 7:18 PM
Subject: Documentation not updating, yet doc build seems fine
To: Geoserver-devel <geoserver-devel@anonymised.comorge.net>

Hi,
the documentation does not seem to be updating anymore, at least for the “latest” link.

For example, see this raw link to github, talking about a new ability in the wps download process (community module):
https://github.com/geoserver/geoserver/blob/master/doc/en/user/source/community/wps-download/rawDownload.rst#writing-parameters

and the documentation published on site (two links to try here):

http://docs.geoserver.org/latest/en/user/community/wps-download/rawDownload.html

http://docs.geoserver.org/master/en/user/community/wps-download/rawDownload.html

I went on the build server to have a look, the documentation build is there, running, and seems to be
doing its job, too:
https://build.geoserver.org/view/geoserver/job/geoserver-master-live-docs/1082/console

The change above is 8 days old, the last live docs build is 2 days old, I’ve checked the revision number it’s
getting, it was up to date, run the same build command on my machine and that generates up to date
documentation.

The copying steps at the end also seem right. So… how come the file comes back outdated on
the doc site?

Wondering if by any chance there is a caching accelerator in the middle that is not seeing file updates?

Cheers
Andrea

==

GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information.

Ing. Andrea Aime
@geowolf
Technical Lead

GeoSolutions S.A.S.
Via di Montramito 3/A
55054 Massarosa (LU)
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 339 8844549

http://www.geo-solutions.it
http://twitter.com/geosolutions_it

AVVERTENZE AI SENSI DEL D.Lgs. 196/2003

Le informazioni contenute in questo messaggio di posta elettronica e/o nel/i file/s allegato/i sono da considerarsi strettamente riservate. Il loro utilizzo è consentito esclusivamente al destinatario del messaggio, per le finalità indicate nel messaggio stesso. Qualora riceviate questo messaggio senza esserne il destinatario, Vi preghiamo cortesemente di darcene notizia via e-mail e di procedere alla distruzione del messaggio stesso, cancellandolo dal Vostro sistema. Conservare il messaggio stesso, divulgarlo anche in parte, distribuirlo ad altri soggetti, copiarlo, od utilizzarlo per finalità diverse, costituisce comportamento contrario ai principi dettati dal D.Lgs. 196/2003.

The information in this message and/or attachments, is intended solely for the attention and use of the named addressee(s) and may be confidential or proprietary in nature or covered by the provisions of privacy act (Legislative Decree June, 30 2003, no.196 - Italy’s New Data Protection Code).Any use not in accord with its purpose, any disclosure, reproduction, copying, distribution, or either dissemination, either whole or partial, is strictly forbidden except previous formal approval of the named addressee(s). If you are not the intended recipient, please contact immediately the sender by telephone, fax or e-mail and delete the information in this message that has been received in error. The sender does not give any warranty or accept liability as the content, accuracy or completeness of sent messages and accepts no responsibility for changes made after they were sent or for other risks which arise as a result of e-mail transmission, viruses, etc.


Check out the vibrant tech community on one of the world’s most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot


Geoserver-devel mailing list
Geoserver-devel@anonymised.comrge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

Regards,

Andrea Aime

==
GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information.

Ing. Andrea Aime
@geowolf
Technical Lead

GeoSolutions S.A.S.
Via di Montramito 3/A
55054 Massarosa (LU)
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 339 8844549

http://www.geo-solutions.it
http://twitter.com/geosolutions_it

AVVERTENZE AI SENSI DEL D.Lgs. 196/2003

Le informazioni contenute in questo messaggio di posta elettronica e/o nel/i file/s allegato/i sono da considerarsi strettamente riservate. Il loro utilizzo è consentito esclusivamente al destinatario del messaggio, per le finalità indicate nel messaggio stesso. Qualora riceviate questo messaggio senza esserne il destinatario, Vi preghiamo cortesemente di darcene notizia via e-mail e di procedere alla distruzione del messaggio stesso, cancellandolo dal Vostro sistema. Conservare il messaggio stesso, divulgarlo anche in parte, distribuirlo ad altri soggetti, copiarlo, od utilizzarlo per finalità diverse, costituisce comportamento contrario ai principi dettati dal D.Lgs. 196/2003.

The information in this message and/or attachments, is intended solely for the attention and use of the named addressee(s) and may be confidential or proprietary in nature or covered by the provisions of privacy act (Legislative Decree June, 30 2003, no.196 - Italy’s New Data Protection Code).Any use not in accord with its purpose, any disclosure, reproduction, copying, distribution, or either dissemination, either whole or partial, is strictly forbidden except previous formal approval of the named addressee(s). If you are not the intended recipient, please contact immediately the sender by telephone, fax or e-mail and delete the information in this message that has been received in error. The sender does not give any warranty or accept liability as the content, accuracy or completeness of sent messages and accepts no responsibility for changes made after they were sent or for other risks which arise as a result of e-mail transmission, viruses, etc.