FLUID-5899: Support multiple versioned deployment for infusion-docs deployment

Metadata

Source
FLUID-5899
Type
Task
Priority
Major
Status
Closed
Resolution
Migrated
Assignee
N/A
Reporter
Cindy Li
Created
2016-05-03T09:50:30.074-0400
Updated
2022-03-14T13:21:15.772-0400
Versions
N/A
Fixed Versions
N/A
Component
  1. Tech. Documentation

Description

The infusion-docs deployment has an issue with the Windows platform that, when running the docpad deployment commands, docpad.js is somehow recognized as an executable, see https://github.com/docpad/docpad/issues/561. An attempt to fix it is to rename docpad.js to docpad-config.js and use docpad "-c" option to load in the renamed config file, but it causes https://issues.fluidproject.org/browse/FLUID-5896 issue, so the attempt was reverted back.

Also, the deployment should be able to support multiple versioned deployment so that for example when Infusion 2.0.0 is released, the docs for 2.0.0 can be permanently deployed to http://docs.fluidproject.org/infusion/2.0.0/, see IRC discussions at https://botbot.me/freenode/fluid-work/2016-05-03/?msg=65356315&page=1

All these indicate it might be worth introducing grunt into infusion-docs that can check out the existing branch, copy to just one directory of it, commit it, delete the remote branch and then regenerate it.

A few references:
Antranig's code of manual grunt copy task: https://github.com/fluid-studios/infusion-onward-video-example/blob/master/Gruntfile.js#L30
An article of how to push a directory to a remote branch as a subtree: https://gist.github.com/cobyism/4730490

Comments

  • Justin Obara commented 2022-03-14T13:21:15.737-0400

    Migrated to Infusion Docs Issue #224