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

Mario Sopena Novales mario.sopena at gmail.com
Mon Dec 10 04:36:48 EST 2007


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.


More information about the Mono-docs-list mailing list