[Mono-docs-list] Differences between generic names in the documentation.

[Mario Sopena Novales]

Hi,

On 10/12/2007, Jonathan Pryor <jonpryor at vt.edu> wrote:
> On Sat, 2007-12-08 at 11:03 -0500, Jonathan Pryor wrote:
>
> In short, we have a trade-off between a more useful (as far as I'm
> concerned) "show all overloads in the Members page" AND use a sensible
> set of characters to distinguish between type paramters and actual
> parameters, vs. a more language-agnostic "only show the Member name, and
> display overloads in a separate page," and in the separate page use ()
> to enclose *both* type parameters AND method parameters.
>
>  - Jon

my opinion is to stay as it is now for several reasons:

* The agnostic solution is just ugly (like esperanto, it wont work
because is not good enough for everybody)

* C# is the primary development language for Mono and almost everybody
programs in C# or, at least, understands C#. Besides that, all the
examples in the documentation are only in C# so we have already a
C#-ish documentation.

* In the future, as other languages take more specific weight, we can
add a "Language" menu that will translate generic, examples and
everything that needs to be done to be more language XX friendly.

Mario