Uploaded image for project: 'Mender'
  1. Mender
  2. MEN-3825

Adjust build+automation for new docs site structure

    XMLWordPrintable

    Details

    • Type: Task
    • Status: Done
    • Priority: (None)
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: None
    • Labels:

      Description

      Switching to a new theme (MEN-2904) and new multisite structure (MEN-3287) will require some changes to our automation and building. Content for each mender-docs branch will need to be placed in a different directory within the mender-docs-site structure.

      Instead of the current location: user/pages/xx.<version>/<content goes here>, each mender-docs branch content should go into user/sites/<version>/pages/<content goes here>.

      On top of that, we have decided to keep the old API rendering for the old versions, so these should now be checked it for the old versions and not rebuild each time.

      STEP 1 Acceptance criteria:

      • For API specs of Mender version 2.4 and lower:
        • Convert swagger to markdown and check in the files in mender-docs (content site)
      • Modify (greatly simplify) the build:
        • Clone markdown files to current location user/pages/xx.<version>/<content goes here>
        • No conversion is needed
      • Publish and verify

      STEP 2 Dependencies:

      STEP 2 Acceptance criteria

      • Modify script to clone into user/sites/<version>/pages/<content goes here>
         

       

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                lluis Lluís Campos
                Reporter:
                a10041 Michael Clelland
              • Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved:

                  Summary Panel