Hi,

Thanks for suggestions, I think 'Creating a dashboard in Grafana' is the right way to go.

Let me explain my motivation here, I was reading the doc as an idiot (which i found worryingly easy yesterday). If I don't know what Grafana is, then mention of 'Grafana dashboards' or 'adding dashboards to Grafana' prompts a question 'what is Grafana?'.

I think we want to mention Grafana, for many reasons, but I hope that 'Creating a dashboard in Grafana' prompts the question 'where is Grafana?' and that users unfamiliar with the name will intuit it as an App/Location instead of a new piece in a poorly fitting jigsaw.

(Jose, I like your addition of context, mentioning the metrics service, but I'm hoping that will be obvious to the user by location of the Grafana topics and the introductory text.)

Paul


On 02/06/2018 08:28 AM, Jose Miguel Gallas Olmedo wrote:
"Adding a Grafana dashboard [to the metrics service]"?



JOSE MIGUEL GALLAS OLMEDO

ASSOCIATE QE, mobile

Red Hat 

M: +34618488633    


On 5 February 2018 at 20:28, David Martin <davmarti@redhat.com> wrote:

From the docs here http://docs.grafana.org/guides/getting_started/#dashboards-panels-rows-the-building-blocks-of-grafana it talks about creating a dashboard, and that dashboards are at the core of Grafana.

So, 'creating a dashboard in Grafana'?


On Mon, 5 Feb 2018 18:04 Paul Wright, <pwright@redhat.com> wrote:
//taking cover already as I'm about to ask people to name things

You don't add a table to Postgres, you add a table to a database,

You don't Firefox a web site.

and in general, you don't add <item> to <product>, you add <item> to
<function or component>

so, I don't like the phrase 'adding a dashboard to Grafana'

I suppose we might 'add a dashboard to the Grafana instance', but that
seems wordy,

And everyone is busy, so I'm going to say either:

a) add a dashboard to the Grafana instance

b) add a dashboard to <AeroGear Reports>

Note: I've spoken to a few ppl about this, and they're looking at me
funny, but I'd like to point out that this is what I'm basing my view on
the fact that a dashboard is not supposed to be a mere visualization:

https://en.wikipedia.org/wiki/Dashboard_(business)

Paul
(waiting for all the counter examples)
--

Paul Wright
Mobile Docs (github: finp)

--
You received this message because you are subscribed to the Google Groups "Aerogear" group.
To unsubscribe from this group and stop receiving emails from it, send an email to aerogear+unsubscribe@googlegroups.com.
To post to this group, send email to aerogear@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/aerogear/0c02be2b-3c73-5fad-bca1-54b60cfc0e5e%40redhat.com.
For more options, visit https://groups.google.com/d/optout.
--
You received this message because you are subscribed to the Google Groups "Aerogear" group.
To unsubscribe from this group and stop receiving emails from it, send an email to aerogear+unsubscribe@googlegroups.com.
To post to this group, send email to aerogear@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/aerogear/CADvBQ45gqTRbx1xO9G78JT93LvGRvP8E4qYoX%2BUGCqQAMQz6jw%40mail.gmail.com.

For more options, visit https://groups.google.com/d/optout.


-- 
Paul Wright
Mobile Docs (github: finp)