community-templates icon indicating copy to clipboard operation
community-templates copied to clipboard

This github repository is not searchable, intuitive, or easy to use

Open jack-valko opened this issue 3 years ago • 7 comments

Unlike share.zabbix.com, this repo is not searchable. This is an important feature on share.zabbix.com that allows users to find templates for their devices. This repo is not easy to use if you want to add a template, not all of us are developers. The layout of template name/version/release is cumbersome and difficult.

Suggestions:

  • ditch this idea and improve zabbix share instead
  • index this github repo on search engines
  • enable the github wiki with a searchable index

jack-valko avatar Jan 22 '22 21:01 jack-valko

Zabbix share was a total mess from a point of adding something new. I tried to add my templates there, and without any response. Here all people have a chance to add a template in a normal way.

But index and wiki are needed, yes.

mtxadmin avatar Jan 26 '22 23:01 mtxadmin

“In a normal way” doesn’t compute. Normal if you use git and understand branching and PR. Not normal if you spend most of your time on Reddit.

Guidance will help.

On Jan 26, 2022, at 3:18 PM, mtxadmin @.***> wrote:

 Zabbix share was a total mess. I tried to add my templates there, and without any response. Here all people have a chance to add a template in a normal way.

But index and wiki are needed, yes.

— Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications on the go with GitHub Mobile for iOS or Android. You are receiving this because you authored the thread.

jack-valko avatar Jan 26 '22 23:01 jack-valko

I disagree. On Github here is a very clear and intuitive web-interface.

mtxadmin avatar Jan 27 '22 21:01 mtxadmin

I would say git is the right place to host this but I do miss comments on each template. You could tell if it was worth downloading and trying.

monotok avatar Jan 27 '22 23:01 monotok

@mtxadmin I disagree with your disagreement. I'm not arguing the github web interface isn't clear or intuitive for doing github stuff. It is unintuitive or incompatible for really important use cases like adding a template, searching for a template, reading comments (those will never exist), and ranking templates (those will never exist). It's a major feature downgrade from what was available on zabbix share.

Speaking as a zabbix community developer, if my potential users can't find my stuff then what am I still doing here?

jack-valko avatar Jan 28 '22 03:01 jack-valko

What could be done is to add a (formal) meta information text file containing summary, description and listing details to the top level of directory of each template (think lsm but much more modern).

This could be in a readme markdown (with some content requirement) so that it that can be rendered directly or a readme file could be automatically generated from the template meta information file (which would improve browsing this repository by itself).

With this one could simply aggregate all those and feed into a frontend system (which could eventually be made as sofisticated as share.zabbix.com).

hlovdal avatar Feb 14 '22 15:02 hlovdal

I do agree that share.zabbix.com does have some nice features I miss here. I'm used to git and grep, but having votes, download numbers, versions, comments is very useful!

nod0n avatar Feb 17 '22 12:02 nod0n