cordova-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF GitHub Bot (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (CB-13925) Files in www/docs/en/dev/reference are not fetched on every build.
Date Fri, 02 Mar 2018 05:00:01 GMT

    [ 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:
users@infra.apache.org


> 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: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org


Mime
View raw message