Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

For now, please annotate that it is slated for removal/deprecation in the annotation as detailed in the how-to document.

How do I document a setting or toggle that can be configured independently for both, LMS and CMS service variants? do I have to duplicate the annotations in both env files?

There are some settings or toggles that are defined in both, LMS and CMS env files. Before duplicating the annotations in both env files, please perform research on the setting/toggle purpose in both service variants. Then you can proceed according to the following scenarios:

  • The setting/toggle servers to the same purpose in both service variants: Document both the LMS and CMS settings using annotations, but make the CMS annotations refer to the LMS annotations rather than duplicating text on both sides.  Use the warning annotation to highlight if the setting/toggle needs to be set in both LMS and CMS with the same value, or any other non-obvious considerations. You can find an excellent example of this case in this pull request, where CMS annotations reference LMS annotations

  • The setting/toggle servers to different or additional purposes: make the annotations differ indicating the purpose for every service variant using the regular steps indicated in this document

Retro

Pluses

  1. Communications

    1. Announced earlier at contributors meeting

    2. Announced in discourse - including banner!

    3. Announced in slack

    4. Separate slack channel was great!

  2. This document was very useful in getting started. Regis’s video was also nice to get started, having the full process recorded would be really nice.

  3. Spreadsheet to self-serve for signups and add notes.

  4. Opening and closing ceremonies!

    1. With Metrics!

...