Would like feedback on HTML page of map projection parameters

[Martin Desruisseaux <ma...@geomatys.com>]

Hello all

I would like a feedback on the following page, which has been
automatically generated (first draft only - more projections will be
added later):

    http://sis.staging.apache.org/content/operation-parameters.html

In particular I would like feedback on:

  * The ".../content/operation-parameters.html" URL. I would like a URL
    which will not change, so that we can refer to it from other web
    sites. My current proposal is to put under "content" everything
    which look like a list of supported things. An other page to provide
    later would be the list of supported EPSG codes for example. Is
    there any other proposal?
  * The table content. I think that the current tables put too much
    information about names, and not enough information about other
    aspects (units of measurement, default value, minimum and maximum
    values). I'm thinking about listing only the EPSG names, and put all
    other names under a HTML <details> tag [1]. This would leave room
    for units, etc.
  * Explanation text in the top of the page, colors, layout, everything...


    Martin


[1] https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details

Re: Would like feedback on HTML page of map projection parameters

[Martin Desruisseaux <ma...@geomatys.com>]

Hello Adam and all

I regenerated the page with a new code. I also changed the URL in an
attempt to make it closer to "OperationMethod", which is the ISO 19111
objects that we are actually listing:

    http://sis.staging.apache.org/content/CoordinateOperationMethods.html

In this new page, I use the new HTML5 <details> tag for hiding the
aliases. Depending on your browser, you may see a symbol on the left
side of the parameter name. Clicking on this symbol expand the aliases.

Unfortunately <details> is not yet supported by Firefox (which is my
usual browser): Firefox show everything, which make the page very
verbose. But <details> works with Safari and Opera (I'm not sure about
Internet Explorer).

If this new layout is considered better and worth to keep, then I don't
know what we should do about Firefox. Alternatives are:

 1. Do nothing and hope that Firefox will not take too long before to
    support the <details> HTML5 tag (the page is not broken in current
    Firefox - it is just much more verbose than expected).
 2. Do not use <details> at all by not providing any alias information.
 3. Create two separated pages, with and without aliases.

What do you think?

    Martin




Le 10/04/15 02:47, Adam Estrada a écrit :
> Martin,
>
> When the page loads, it's a wall of text that makes my face melt. But, the
> content is sound so we need to find a way to make it a little less scary. I
> think letting the EPSG codes be the guide for the rest of the content is
> the win here. I feel like that is common practice these days...
>
> /operation-parameters.html is fine. Honestly, I don't know if the name of
> the page really matters. People will bookmark it and forget what the name
> ever was. The title of the page also, probably doesn't matter. It is
> operation parameters so why not let it stay?
>
> Adam

Re: Would like feedback on HTML page of map projection parameters

[Adam Estrada <es...@gmail.com>]

Martin,

When the page loads, it's a wall of text that makes my face melt. But, the
content is sound so we need to find a way to make it a little less scary. I
think letting the EPSG codes be the guide for the rest of the content is
the win here. I feel like that is common practice these days...

/operation-parameters.html is fine. Honestly, I don't know if the name of
the page really matters. People will bookmark it and forget what the name
ever was. The title of the page also, probably doesn't matter. It is
operation parameters so why not let it stay?

Adam



On Thu, Apr 9, 2015 at 7:07 PM, Martin Desruisseaux <
martin.desruisseaux@geomatys.com> wrote:

> Hello all
>
> I would like a feedback on the following page, which has been
> automatically generated (first draft only - more projections will be
> added later):
>
>     http://sis.staging.apache.org/content/operation-parameters.html
>
> In particular I would like feedback on:
>
>   * The ".../content/operation-parameters.html" URL. I would like a URL
>     which will not change, so that we can refer to it from other web
>     sites. My current proposal is to put under "content" everything
>     which look like a list of supported things. An other page to provide
>     later would be the list of supported EPSG codes for example. Is
>     there any other proposal?
>   * The table content. I think that the current tables put too much
>     information about names, and not enough information about other
>     aspects (units of measurement, default value, minimum and maximum
>     values). I'm thinking about listing only the EPSG names, and put all
>     other names under a HTML <details> tag [1]. This would leave room
>     for units, etc.
>   * Explanation text in the top of the page, colors, layout, everything...
>
>
>     Martin
>
>
> [1] https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details
>
>