[ 
https://issues.apache.org/jira/browse/FLINK-19513?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17212258#comment-17212258
 ] 

Matthias edited comment on FLINK-19513 at 10/13/20, 10:18 AM:
--------------------------------------------------------------

I'm using the {{docker/run.sh}} to start the docker container calling 
{{./build_docs.sh -i}} and {{./build_docs.sh -p}} (I tried both) from within 
the Docker container. Updating the docs, in my case 
{{docs/monitoring/metrics.md}}, does not trigger regeneration of the docs.

My setup:
{noformat}
$ ruby -version 
ruby 2.5.5p157 (2019-03-15 revision 67260) [x86_64-linux]
{noformat}
{noformat}
$ ./build_docs.sh -p
[...]
Using jekyll 4.0.1
[...]{noformat}
{noformat}
$ cat /etc/os-release 
NAME=Fedora VERSION="28 (Twenty Eight)" 
ID=fedora VERSION_ID=28 
PLATFORM_ID="platform:f28" 
PRETTY_NAME="Fedora 28 (Twenty Eight)" 
ANSI_COLOR="0;34" 
CPE_NAME="cpe:/o:fedoraproject:fedora:28" 
HOME_URL="https://fedoraproject.org/"; 
SUPPORT_URL="https://fedoraproject.org/wiki/Communicating_and_getting_help"; 
BUG_REPORT_URL="https://bugzilla.redhat.com/"; 
REDHAT_BUGZILLA_PRODUCT="Fedora" 
REDHAT_BUGZILLA_PRODUCT_VERSION=28 
REDHAT_SUPPORT_PRODUCT="Fedora" 
REDHAT_SUPPORT_PRODUCT_VERSION=28 
PRIVACY_POLICY_URL="https://fedoraproject.org/wiki/Legal:PrivacyPolicy";
{noformat}


was (Author: mapohl):
I'm using the `docker/run.sh` to start the docker container calling 
`./build_docs.sh -i` and `./build_docs.sh -p` (I tried both) from within the 
Docker container. Updating the docs, in my case `docs/monitoring/metrics.md`, 
does not trigger regeneration of the docs.

My setup:
{noformat}
$ ruby -version 
ruby 2.5.5p157 (2019-03-15 revision 67260) [x86_64-linux]
{noformat}
{noformat}
$ ./build_docs.sh -p
[...]
Using jekyll 4.0.1
[...]{noformat}
{noformat}
$ cat /etc/os-release 
NAME=Fedora VERSION="28 (Twenty Eight)" 
ID=fedora VERSION_ID=28 
PLATFORM_ID="platform:f28" 
PRETTY_NAME="Fedora 28 (Twenty Eight)" 
ANSI_COLOR="0;34" 
CPE_NAME="cpe:/o:fedoraproject:fedora:28" 
HOME_URL="https://fedoraproject.org/"; 
SUPPORT_URL="https://fedoraproject.org/wiki/Communicating_and_getting_help"; 
BUG_REPORT_URL="https://bugzilla.redhat.com/"; 
REDHAT_BUGZILLA_PRODUCT="Fedora" 
REDHAT_BUGZILLA_PRODUCT_VERSION=28 
REDHAT_SUPPORT_PRODUCT="Fedora" 
REDHAT_SUPPORT_PRODUCT_VERSION=28 
PRIVACY_POLICY_URL="https://fedoraproject.org/wiki/Legal:PrivacyPolicy";
{noformat}

> Update docs/build_docs.sh to support the new parameters for regenerating the 
> docs
> ---------------------------------------------------------------------------------
>
>                 Key: FLINK-19513
>                 URL: https://issues.apache.org/jira/browse/FLINK-19513
>             Project: Flink
>          Issue Type: Improvement
>          Components: Documentation
>            Reporter: Matthias
>            Assignee: Kyle Zhang
>            Priority: Minor
>              Labels: pull-request-available, starter
>
> I came across Jekyll's regeneration feature not working anymore. After doing 
> some research I found [this 
> thread|https://github.com/jekyll/jekyll/issues/2926] stating that 
> {{--force_polling}} should work. A test confirmed that the regeneration takes 
> place with this parameter enabled.
> The {{--watch}} parameter seems to be obsolete.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

Reply via email to