zulip/zulip-terminal

Migrate from 'Stream' to 'Channel' naming

neiljp opened this issue · 0 comments

Client terminology migration description

Like other migrations of this type, this should eventually include updating:

  • User-visible UI
  • Documentation
  • Any API usage
  • Terminology internal to the application

In terms of priority, the first two areas are the most important, followed by the API and internal terminology. The latter areas may be small (easy to do with the initial work) or large (which could be broken into separate issues later).

The substitution in each case should be fairly straightforward, however for this migration it is important to

  • confirm at which Zulip feature level the Server (web app) made this change (see the API changelog)
  • ensure the UI shows the appropriate term based on the server (zulip) feature level (ZFL in our source), so using an older server will look similar to the web app and mobile
  • update the documentation to 'Channel', but possibly add a FAQ entry for the renaming? (eg. mismatch between UI & docs?
  • only use any updated API language after the associated feature level at which they were introduced (which may be different to the UI change ZFL)

Resources for this migration: