On 29 Feb 13:25, apoorve kalot wrote: > Hello all, > > I have some ideas which i want to work upon, under Prometheus, i don't know > if it would be of that level, but i need of opinion of your all.
Hello, Thanks for your ideas. > The idea is, *developing a series of official YouTube tutorials which will > be part of official Documentation* for working and playing with Prometheus, > like from basics of node exporter to writing custom exporter in custom > language, or working with 3rd party exporters, > > *Why it is necessary/ should be done* : In the community IRC, there are > times when people might ask a information, which might be redundant, or > might be useful to other user at later point of time, and these tutorials, > or videos about basic misconceptions, would help to clear all these related > problems I don't see why that can't be handled by current documentation. Videos have downsides, like they take time to read, are hard to update, and are not easy to use for everyone. Think about people with disabilities. > *Example* : Some of the other open source communities have these playlist > as part of official documentation, which helps community as well, along > with people who want use/contribute to the product itself, like Kubernetes, > TensorFlow, etc. > > *Advantages of using it* : > * The Redundant discussion of basic usage of Prometheus and other related > tools. In any way that would be redundant with our written documentation > * Would indirectly help in extending support to community itself, and thus > would also help in getting new members/contributors which might turn into > individual maintainers as well. > * Learning through videos is more efficient as compared to documentation, > or written stuff [ for this opinion not all might be in favor, but everyone > would agree about the fact that former is faster than latter one ]. For > serious bugs and problems, one can always refer and ask help back from > Prometheus community IRC. Some videos exists on some concepts, thinking about: 1/ promcon talks https://promcon.io/2016-berlin/talks/prometheus-design-and-philosophy/ https://promcon.io/2016-berlin/talks/life-of-a-label/ https://promcon.io/2017-munich/talks/staleness-in-prometheus-2-0/ https://promcon.io/2017-munich/talks/storing-16-bytes-at-scale/ 2/ Robust Perception trainings https://training.robustperception.io/ 3/ lots of youtube videos https://www.youtube.com/results?search_query=prometheus+monitoring > These videos, other than basic implementation, would also contain basic > practices which involves while using Prometheus and it's services. > > Note : i haven't have selected the specifics topics which should be > included in these videos, but i would be asking other > Developers/Maintainers of the Prometheus as well as regular users of > Prometheus. [ I asked some of the maintainers on IRC and they liked the > idea, so i posted it here with some courage : ) ] > > Hoping to get your response/criticism about this, Thank you. I do think personally that videos are not a nice way to provide documentation. They could cover very high level overviews but for the real stuff, amendable, copy-pastable, and available to people with disabilities written docs sound be a lot better. Maybe we can add a list of good videos in the docs; but that should not substitute them. From what I see on youtube a lot of topics are covered already by the community. -- (o- Julien Pivotto //\ Open-Source Consultant V_/_ Inuits - https://www.inuits.eu -- You received this message because you are subscribed to the Google Groups "Prometheus Developers" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/prometheus-developers/20200229213730.GA23318%40oxygen.
signature.asc
Description: PGP signature
