Details

    • Type: Sub-task
    • Status: Open
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: cordova-docs
    • Labels:
      None

      Description

      Per https://github.com/apache/cordova-docs/blob/master/README.md#building and https://github.com/apache/cordova-docs/blob/master/README.md#developing the build process of the website is handled by `gulp`.

      https://github.com/apache/cordova-docs/blob/master/README.md#installing tells us to install Ruby, python, Node.js, the dependencies _for both Ruby and Node, and optionally _Make.

      From looking at `www` I know the website is actually a Jekyll website.

      This leads to a very confused me and several questions:

      1. How does the build process with Make work? Is this documented?
      2. What is python required for?
      3. What is node.js required for? gulp?
      4. What does the gulp thing actually do? The README only mentions serve, watch, build - but the gulpfile contains so much more.
      5. What workflows or processes are "hidden" in the gulpfile that should better be documented?
      6. What is the difference between PROD and DEV in this build process?
      7. How does the fetching of external docs work?
      8. Is there anything about translations in there?

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                Unassigned
                Reporter:
                Sujan12 Jan Piotrowski (janpio)
              • Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated: