Bug#979492: jami: Package description should be improved
Hi Bruno, :-) Thank you for your patch. I've opened a merge request with improvements to both the package description and the appstream metadata: https://salsa.debian.org/pkg-voip-team/ring/-/merge_requests/5 Alexandre, would you please merge this? Thanks, -- Amin Bandali Free Software Consultant Savoir-faire Linux jami:bandali
Bug#979492: jami: Package description should be improved
Hi Jonas, Am Donnerstag, dem 07.01.2021 um 14:14 +0100 schrieb Jonas Smedegaard: > Hi again, Bruno, > > Quoting Bruno Kleinert (2021-01-07 13:32:34) > > Am Donnerstag, dem 07.01.2021 um 12:34 +0100 schrieb Jonas Smedegaard: > > > Quoting Bruno Kleinert (2021-01-07 11:46:08) > > > > the package description is too "shy" and should include buzzwords > > > > and search terms. > > > > > > > > Since other video conference tools like BigBlueButton and Jitsi > > > > Meet are not included in Debian, Jami can partly substitute those. > > > > An improved description can help users to find Jami as a solution > > > > for their needs in the package archive. > > > > > > No, goal of package description is not to sell but to inform: Avoid > > > buzzwords but include actual facts. > > > > Maybe the paragraph "To some degree Jami provides similar […]" is too > > much. > > From where are you quoting the above? > > It would probably help if you propose a concrete text to replace or be > appended to existing package description. My apologies if that is > exactly what you did already and I simply missed it somehow. > > [ after re-reading original post, and then again a third time...] > > HHH, now I see your patch. I am very sorry, I totally missed that > in my first reply. Ah, that explains your first reply! :) When I read it I was wondering "Phhh, did he even just ignore the patch?!" :D > > Your proposed patch looks fine to me. Only part I dislike is the > paragraph linking to upstream and enumerating other platforms: Package > has a Homepage field to reference upstream, and I find it better to > mention more broadly that "Jami is available on non-Linux paltforms as > well." > > Also, concretely, the paragraph "To some degree..." looks fine to me. > > > > However, everything else is facts. My use of the word buzzwords was > > probably wrong, I meant search terms that users likely apt search for > > to find a substitution of a proprietary (Skype, WhatsApp, …) program > > or something that is not yet available in Debian (BBB, Jitsi Meet). > > It was the word buzzwords that made me react strongly - I do agree with > you that current package description is vague. Sorry that I did not > make that clear. > > > > Please reconsider your decision, the patch is intended to support our > > users. > > To clarify, I am providing input on this bugreport but not "deciding". > Sorry if my opinions come across as definitive. > > > - Jonas > Never mind, I'm glad we sorted out the misunderstanding early before any pillow fight started :) From the Uploaders field I assume Alexandre may be the one who decides how to proceed. Cheers, Bruno signature.asc Description: This is a digitally signed message part
Bug#979492: jami: Package description should be improved
Hi again, Bruno, Quoting Bruno Kleinert (2021-01-07 13:32:34) > Am Donnerstag, dem 07.01.2021 um 12:34 +0100 schrieb Jonas Smedegaard: > > Quoting Bruno Kleinert (2021-01-07 11:46:08) > > > the package description is too "shy" and should include buzzwords > > > and search terms. > > > > > > Since other video conference tools like BigBlueButton and Jitsi > > > Meet are not included in Debian, Jami can partly substitute those. > > > An improved description can help users to find Jami as a solution > > > for their needs in the package archive. > > > > No, goal of package description is not to sell but to inform: Avoid > > buzzwords but include actual facts. > > Maybe the paragraph "To some degree Jami provides similar […]" is too > much. >From where are you quoting the above? It would probably help if you propose a concrete text to replace or be appended to existing package description. My apologies if that is exactly what you did already and I simply missed it somehow. [ after re-reading original post, and then again a third time...] HHH, now I see your patch. I am very sorry, I totally missed that in my first reply. Your proposed patch looks fine to me. Only part I dislike is the paragraph linking to upstream and enumerating other platforms: Package has a Homepage field to reference upstream, and I find it better to mention more broadly that "Jami is available on non-Linux paltforms as well." Also, concretely, the paragraph "To some degree..." looks fine to me. > However, everything else is facts. My use of the word buzzwords was > probably wrong, I meant search terms that users likely apt search for > to find a substitution of a proprietary (Skype, WhatsApp, …) program > or something that is not yet available in Debian (BBB, Jitsi Meet). It was the word buzzwords that made me react strongly - I do agree with you that current package description is vague. Sorry that I did not make that clear. > Please reconsider your decision, the patch is intended to support our > users. To clarify, I am providing input on this bugreport but not "deciding". Sorry if my opinions come across as definitive. - Jonas -- * Jonas Smedegaard - idealist & Internet-arkitekt * Tlf.: +45 40843136 Website: http://dr.jones.dk/ [x] quote me freely [ ] ask before reusing [ ] keep private signature.asc Description: signature
Bug#979492: jami: Package description should be improved
Hi Jonas, Am Donnerstag, dem 07.01.2021 um 12:34 +0100 schrieb Jonas Smedegaard: > Quoting Bruno Kleinert (2021-01-07 11:46:08) > > the package description is too "shy" and should include buzzwords and > > search terms. > > > > Since other video conference tools like BigBlueButton and Jitsi Meet > > are not included in Debian, Jami can partly substitute those. An > > improved description can help users to find Jami as a solution for > > their needs in the package archive. > > No, goal of package description is not to sell but to inform: Avoid > buzzwords but include actual facts. Maybe the paragraph "To some degree Jami provides similar […]" is too much. However, everything else is facts. My use of the word buzzwords was probably wrong, I meant search terms that users likely apt search for to find a substitution of a proprietary (Skype, WhatsApp, …) program or something that is not yet available in Debian (BBB, Jitsi Meet). > > My common approach is to pick a few essential sentences from upstream > README, remove any buzz and irrelevant parts (like "it is fully free > software"), and then compare with and borrow from first paragraph of > Wikipedia article if such exist. > > I would propose to add this text, based solely on Wikipedia article > (because a quick look at source README and upstream Homepage didn't > provide any usable text at all): > > > Jami (formerly GNU Ring, SFLphone) is a SIP-compatible distributed > > peer-to-peer softphone and SIP-based instant messenger client, similar > > in functionality to the proprietary Skype. I have the pandemic situation in my mind: People who apt search for a solution to place video calls. I ran the following commands in Debian unstable to search for packages to place video calls: LC_ALL=C apt-cache search video call LC_ALL=C apt-cache search video conference Only the first one lists at least gajim as the only sort-of straight- forward package in the results. Gajim requires a proper server set up to allow video calls with compatible clients and only works under X11 at the moment, however. Due to the poor package description, jami is not among the search results and it wouldn't be with the description from Wikipedia. It provides a solution for the search terms, however. Please reconsider your decision, the patch is intended to support our users. Cheers, Bruno signature.asc Description: This is a digitally signed message part
Bug#979492: jami: Package description should be improved
Quoting Bruno Kleinert (2021-01-07 11:46:08) > the package description is too "shy" and should include buzzwords and > search terms. > > Since other video conference tools like BigBlueButton and Jitsi Meet > are not included in Debian, Jami can partly substitute those. An > improved description can help users to find Jami as a solution for > their needs in the package archive. No, goal of package description is not to sell but to inform: Avoid buzzwords but include actual facts. My common approach is to pick a few essential sentences from upstream README, remove any buzz and irrelevant parts (like "it is fully free software"), and then compare with and borrow from first paragraph of Wikipedia article if such exist. I would propose to add this text, based solely on Wikipedia article (because a quick look at source README and upstream Homepage didn't provide any usable text at all): > Jami (formerly GNU Ring, SFLphone) is a SIP-compatible distributed > peer-to-peer softphone and SIP-based instant messenger client, similar > in functionality to the proprietary Skype. - Jonas -- * Jonas Smedegaard - idealist & Internet-arkitekt * Tlf.: +45 40843136 Website: http://dr.jones.dk/ [x] quote me freely [ ] ask before reusing [ ] keep private signature.asc Description: signature
Bug#979492: jami: Package description should be improved
Package: jami Version: 20210104.4.dda80df~ds1-1 Severity: minor Tags: patch X-Debbugs-Cc: fu...@debian.org Hi, the package description is too "shy" and should include buzzwords and search terms. Since other video conference tools like BigBlueButton and Jitsi Meet are not included in Debian, Jami can partly substitute those. An improved description can help users to find Jami as a solution for their needs in the package archive. Cheers, Bruno -- System Information: Debian Release: bullseye/sid APT prefers unstable-debug APT policy: (500, 'unstable-debug'), (500, 'unstable'), (1, 'experimental-debug'), (1, 'experimental') Architecture: amd64 (x86_64) Kernel: Linux 5.10.0-1-amd64 (SMP w/8 CPU threads) Locale: LANG=de_DE.utf8, LC_CTYPE=de_DE.utf8 (charmap=UTF-8) (ignored: LC_ALL set to de_DE.utf-8), LANGUAGE not set Shell: /bin/sh linked to /usr/bin/dash Init: systemd (via /run/systemd/system) LSM: AppArmor: enabled Versions of packages jami depends on: ii dconf-gsettings-backend [gsettings-backend] 0.38.0-1 ii jami-daemon 20210104.4.dda80df~ds1-1 ii libayatana-appindicator3-1 0.5.5-2 ii libc62.31-7 ii libcairo21.16.0-5 ii libcanberra-gtk3-0 0.30-7 ii libcanberra0 0.30-7 ii libclutter-1.0-0 1.26.4+dfsg-2 ii libclutter-gtk-1.0-0 1.8.4-4 ii libgcc-s110.2.1-3 ii libgdk-pixbuf-2.0-0 2.42.2+dfsg-1 ii libglib2.0-0 2.66.4-1 ii libgtk-3-0 3.24.24-1 ii libnm0 1.28.0-2 ii libnotify4 0.7.9-2 ii libpango-1.0-0 1.46.2-3 ii libqrencode4 4.1.1-1 ii libqt5core5a 5.15.2+dfsg-2 ii libqt5dbus5 5.15.2+dfsg-2 ii libqt5gui5 5.15.2+dfsg-2 ii libqt5sql5 5.15.2+dfsg-2 ii libqt5sql5-sqlite5.15.2+dfsg-2 ii libstdc++6 10.2.1-3 ii libwebkit2gtk-4.0-37 2.30.4-1 ii libx11-6 2:1.6.12-1 jami recommends no packages. jami suggests no packages. -- no debconf information >From 433915507e5311ca5e43a52034e0df840b1de9cf Mon Sep 17 00:00:00 2001 From: Bruno Kleinert Date: Thu, 7 Jan 2021 11:28:55 +0100 Subject: [PATCH] Add buzzwords to package description --- debian/control | 52 +--- 1 file changed, 45 insertions(+), 7 deletions(-) diff --git a/debian/control b/debian/control index d51bf65..e279d86 100644 --- a/debian/control +++ b/debian/control @@ -79,21 +79,59 @@ Depends: ${shlibs:Depends}, Replaces: ring (<< 20190101.3.5315d84~) Breaks: ring (<< 20190101.3.5315d84~) Description: Secure and distributed voice, video and chat platform - desktop client - Jami (jami.net) is a secure and distributed voice, video and chat communication - platform that requires no centralized server and leaves the power of privacy - in the hands of the user. + Jami is a secure and distributed voice, video and chat communication platform + that requires no centralized server and leaves the power of privacy in the + hands of users. . - This package contains the desktop client: gnome-ring. + To some degree Jami provides similar functionality like Skype, WhatsApp, + Telegram, BigBlueButton, Jitsi Meet, etc. do. + . + Jami supports the following key features: + * Text chats and group chats + * Share files + * Audio calls + * Audio conferences + * Video calls + * Video conferences + * Leave audio messages + * Leave video messages + * End-to-end encryption + . + Jami can also serve as a SIP software phone. + . + On https://jami.net/ clients for Windows, Mac, iPhone and Android are available + which makes Jami interoperable. + . + This package contains the desktop client: jami-gnome. Package: jami-daemon Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends} Replaces: ring-daemon (<< 20190101.3.5315d84~) Breaks: ring-daemon (<< 20190101.3.5315d84~) Description: Secure and distributed voice, video and chat platform - daemon - Jami (jami.net) is a secure and distributed voice, video and chat communication - platform that requires no centralized server and leaves the power of privacy - in the hands of the user. + Jami is a secure and distributed voice, video and chat communication platform + that requires no centralized server and leaves the power of privacy in the + hands of users. + . + To some degree Jami provides similar functionality like Skype, WhatsApp, + Telegram, BigBlueButton, Jitsi