[
https://issues.apache.org/jira/browse/CB-13925?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16383170#comment-16383170
]
ASF GitHub Bot commented on CB-13925:
-------------------------------------
dblotsky commented on issue #793: [CB-13925] Making file fetch happen on every
build.
URL: https://github.com/apache/cordova-docs/pull/793#issuecomment-369821049
@janpio if you want to know which tasks there are, you run `gulp`, and it
prints out a whole page describing itself. It's already documented, exactly at
the point where you would need the doc: when you use the build system.
Moreover, I think if you want to work on the docs system (not just modifying
contents of the docs), you do need to know the implementation. For example that
extra doc section does describe the implementation, since you never actually
need to run `gulp fetch`, the same way you never run `gulp styles`. It runs
automatically, as part of the build dependency graph.
Since you and @stevengill have been working on the docs a fair bit, I
thought it might be useful for me to pass some of the implementation knowledge
to you (because reading the code is less efficient, but still just as
informative). I also think because you folks are working on this, you might
have more opportunities to document the implementation than I will. However, I
could try and find some time to document this in the next few months if you
think it will be valuable.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
> Files in www/docs/en/dev/reference are not fetched on every build.
> ------------------------------------------------------------------
>
> Key: CB-13925
> URL: https://issues.apache.org/jira/browse/CB-13925
> Project: Apache Cordova
> Issue Type: Bug
> Components: cordova-docs
> Reporter: Dmitry Blotsky
> Priority: Major
>
> Some files in the docs are downloaded from external sources, into
> {{www/docs/en/dev/reference}}. The files and their sources are defined in
> {{cordova-docs/www/_data/fetched-files.yml}}, and downloaded by the {{gulp
> fetch}} task, which runs on every build.
> Expected behaviour: the files are fetched every time the command runs.
> Actual behaviour: the files are only fetched if the
> {{www/docs/en/dev/reference}} directory doesn't exist. That is, fetching is
> skipped every time after the first time.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
