WP-519: APCD Custom getting started page - more standard & compatible

[wesleyboar]

Overview

Overwrite template, instead of creating a new one, so that settings need not be updated.*

What is wrong with updating the setting?

Such a settings update in my experience has not been backwards-compatible (prod page will break upon deploy) nor future-compatible (not using a custom template in future, prod page will break upon deploy).

Fail Case

0. Deploy project

   • with guide template setting path "B"
   • to a server that guide template setting path "A".

1. Open existing page that uses "Guide: Getting Started" template.

2. Notice page crash…
   ^{(unless someone updated page after deploy via /admin UI to use guide template setting path "A" before visiting the page)}

   

Related

• WP-519
• simplifies WP-519: APCD Custom getting started page #281

Changes

• moved a template
  ^{added text to distinguish template from the Core-CMS one it overwrites}

Testing

Local

1. Follow "Start Project" instructions.
2. Create/Update /apcd-cms/src/taccsite_cms/settings_custom.py with pre–WP-519 settings.
3. Create a page.
4. Set template to "Guide: Getting Started".
5. Verify page content is from modified template.

Remote

1. Deploy this to a server.
2. If page is set to use new template, then expect page to fail to load.
3. If so, then via /admin change template to original template path.
4. Notice new template is used (at old template path).

UI

[chandra-tacc]

Thanks for this fix, works great. Will follow this in future.