zulip-desktop icon indicating copy to clipboard operation
zulip-desktop copied to clipboard

Deduplicate documentation for desktop app installations

Open timabbott opened this issue 4 years ago • 6 comments

We have 4 documents on how to install the desktop app:

  • https://zulip.com/apps
  • https://zulip.com/help/desktop-app-install-guide (HTML for production, most visually polished)
  • https://github.com/zulip/zulip-desktop/blob/master/how-to-install.md (production)
  • https://github.com/zulip/zulip-desktop/blob/master/development.md (development)

I think ideally we'd eliminate how-to-install.md by merging it into desktop-app-install-guide (with some polishing), and make sure we have the appropriate set of links?

timabbott avatar Dec 18 '20 02:12 timabbott

@timabbott I am currently getting started with zulip desktop. Should I try setting one for production and on the way working on this issue, improving the guide?

Signior-X avatar Dec 18 '20 15:12 Signior-X

I actually installed and read both the docs for installing the desktop app on windows and ubuntu. I found that the links and information present in how-to-install.md are all present in desktop-install-guide In case of macOS and windows, it was almost same.

In case of linux OS, for ones who use apt like Ubuntu, the how-to-install.md explains the steps one by one and better than desktop-app-install-guide. I guess, we can polish in that area and then we can easily remove how-to-install.md file.

However, I think we have to also change where the links of how-to-install-guide.md are used. Any suggestions, how that can be done?

Signior-X avatar Dec 28 '20 15:12 Signior-X

Hey, @timabbott I have linked a PR for this issue can you please review it?

tarun8718 avatar Jan 08 '21 06:01 tarun8718

@zulipbot claim

raquelbryant avatar Apr 23 '22 04:04 raquelbryant

Working on a pull request but having issues passing some checks

raquelbryant avatar Apr 24 '22 14:04 raquelbryant

@raquelbryant You have been unassigned from this issue because you have not made any updates for over 14 days. Please feel free to reclaim the issue if you decide to pick up again. Thanks!

zulipbot avatar May 04 '22 19:05 zulipbot