[Factor-talk] help.markup: Add icon legend for link-icon?

[Sankaranarayanan Viswanathan]

Hi,

The browser tool shows vocabularies and words with different icons, and 
I thought it would be nice if we could show what the icons meant 
somewhere (or maybe the icons are already described somewhere and I 
couldn't find it). The icons themselves are present in 
basic:definitions.icons. Some implementation ideas I had were:

(a) Have a legend article and put a link in vocabs-docs. Maybe the 
definitions.icons doc could be modified to include a legend and a link 
to this put out on the vocabs-docs (e.g. a link named "Icon legend" 
under the existing "Vocabulary authors" link

(b) Show a tool-tip on hover over the icon. The tool-tip text could be 
derived from the icon file name. But, this might look misleading for the 
"open-vocab" icon since the user could be scratching his head expecting 
how to "open vocab" ;)

Let me know what sounds most reasonable and I can submit a pull request 
if we think having this makes sense.

Thanks,
Sankar


--
___
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk

Re: [Factor-talk] help.markup: Add icon legend for link-icon?

[John Benediktsson]

We should link the docs a bit better, but that does kind of exist:

http://docs.factorcode.org/content/article-definitions.icons.html

Also, we should probably improve those icons, hah.

I think the tooltip might be confusing like you say, but if you want to try
out the tooltip and see if it is awesome, go for it!



On Sat, Dec 12, 2015 at 2:09 AM, Sankaranarayanan Viswanathan <
rationalrev...@gmail.com> wrote:

> Hi,
>
> The browser tool shows vocabularies and words with different icons, and
> I thought it would be nice if we could show what the icons meant
> somewhere (or maybe the icons are already described somewhere and I
> couldn't find it). The icons themselves are present in
> basic:definitions.icons. Some implementation ideas I had were:
>
> (a) Have a legend article and put a link in vocabs-docs. Maybe the
> definitions.icons doc could be modified to include a legend and a link
> to this put out on the vocabs-docs (e.g. a link named "Icon legend"
> under the existing "Vocabulary authors" link
>
> (b) Show a tool-tip on hover over the icon. The tool-tip text could be
> derived from the icon file name. But, this might look misleading for the
> "open-vocab" icon since the user could be scratching his head expecting
> how to "open vocab" ;)
>
> Let me know what sounds most reasonable and I can submit a pull request
> if we think having this makes sense.
>
> Thanks,
> Sankar
>
>
>
> --
> ___
> Factor-talk mailing list
> Factor-talk@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/factor-talk
>
--
___
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk

Re: [Factor-talk] help.markup: Add icon legend for link-icon?

[Sankaranarayanan Viswanathan]

Ah, I did not look closely enough - the link is right there on the 
definitions.icons vocab docs!

Thanks,
Sankar

On 12/12/15 9:30 PM, John Benediktsson wrote:
> We should link the docs a bit better, but that does kind of exist:
>
> http://docs.factorcode.org/content/article-definitions.icons.html
>
> Also, we should probably improve those icons, hah.
>
> I think the tooltip might be confusing like you say, but if you want to
> try out the tooltip and see if it is awesome, go for it!
>
>
>
> On Sat, Dec 12, 2015 at 2:09 AM, Sankaranarayanan Viswanathan
>  > wrote:
>
> Hi,
>
> The browser tool shows vocabularies and words with different icons, and
> I thought it would be nice if we could show what the icons meant
> somewhere (or maybe the icons are already described somewhere and I
> couldn't find it). The icons themselves are present in
> basic:definitions.icons. Some implementation ideas I had were:
>
> (a) Have a legend article and put a link in vocabs-docs. Maybe the
> definitions.icons doc could be modified to include a legend and a link
> to this put out on the vocabs-docs (e.g. a link named "Icon legend"
> under the existing "Vocabulary authors" link
>
> (b) Show a tool-tip on hover over the icon. The tool-tip text could be
> derived from the icon file name. But, this might look misleading for the
> "open-vocab" icon since the user could be scratching his head expecting
> how to "open vocab" ;)
>
> Let me know what sounds most reasonable and I can submit a pull request
> if we think having this makes sense.
>
> Thanks,
> Sankar
>
>
> 
> --
> ___
> Factor-talk mailing list
> Factor-talk@lists.sourceforge.net
> 
> https://lists.sourceforge.net/lists/listinfo/factor-talk
>
>
>
>
> --
>
>
>
> ___
> Factor-talk mailing list
> Factor-talk@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/factor-talk
>



--
___
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk