[racket] Misleading label when registering with pkg.racket-lang.org

From: Jay McCarthy (jay.mccarthy at gmail.com)
Date: Mon Apr 8 07:51:42 EDT 2013

"Package name" is a technical concept defined in the documentation
(section 1, the first bullet on the page). This name is used
throughout the system to refer to dependencies, install arguments,
etc.

The package system only deals with its own terms and concepts, so it
explicitly ignores the first kind of "name" you mention.

The official PNR allows you to track additional information, such as a
free-form text description and "tags". I would suggest that if your
package has an informal "name", then you should mention it in the
description. The eventual DrRacket GUI will probably display these
descriptions when using the official PNR.

Jay


On Sun, Apr 7, 2013 at 8:19 AM, Jens Axel Søgaard <jensaxel at soegaard.net> wrote:
>> "Typed Racket" is not valid because it contains a space.
>
> Let me rephrase the question.
>
> A package has a two names. One is used informally among people to refer to a
> package. This could be Typed-Racket. The other is the name used in the
> package system this could be typed-racket.
>
> Is it clear from the context which one is meant?
>
> /Jens Axel
>
>
>
>
> 2013/4/7 Jay McCarthy <jay.mccarthy at gmail.com>
>>
>> On Sun, Apr 7, 2013 at 7:51 AM, Jens Axel Søgaard <jensaxel at soegaard.net>
>> wrote:
>> > Let's say I want to submit Typed Racket as a package.
>> > Is the package name "Typed Racket" or typed-racket ?
>>
>> "Typed Racket" is not valid because it contains a space.
>>
>> > I just got a 503 from pkg.racket-lang.org, so I check whether
>> > it is clear from the context what is meant.
>>
>> I just fixed it
>>
>> >   /Jens Axel
>> >
>> >
>> >
>> > 2013/4/6 Robby Findler <robby at eecs.northwestern.edu>
>> >>
>> >> I just tried clicking thru this too and I think just putting "Package
>> >> Name" near the top where it says "Name" is a suitable fix.
>> >>
>> >> Robby
>> >>
>> >>
>> >> On Sat, Apr 6, 2013 at 3:54 PM, Jay McCarthy <jay.mccarthy at gmail.com>
>> >> wrote:
>> >>>
>> >>> After having clicked on a link that says "Contribute a Package", I
>> >>> don't think it is unreasonable to think that a user would know they
>> >>> had to give the information about the package, including fundamental
>> >>> information like its name.
>> >>>
>> >>> If you still disagree, I think it would be easy to submit a patch:
>> >>>
>> >>>
>> >>>
>> >>> https://github.com/plt/racket/blob/master/collects/meta/pkg-index/official/main.rkt#L606
>> >>>
>> >>> If you'd like, I can make the patch myself, but I think it may be more
>> >>> productive to figure out the deeper reason why it is hard to tell that
>> >>> "Contribute a Package" goes to a package information form and fix
>> >>> that, rather than just changing a text string.
>> >>>
>> >>> Jay
>> >>>
>> >>> On Thu, Apr 4, 2013 at 5:51 PM, Tony Garnock-Jones <tonyg at ccs.neu.edu>
>> >>> wrote:
>> >>> > I just tried to register a package with pkg.racket-lang.org. First I
>> >>> > registered an account, by typing in an email address and fresh
>> >>> > password.
>> >>> >
>> >>> > The next step was a webpage prompting me for "Name" and some other
>> >>> > fields. I didn't realise it was asking me for the *package* name,
>> >>> > and
>> >>> > thought it was looking for *my* name! Fortunately, it rejected the
>> >>> > package name "Tony Garnock-Jones" because it had a hyphen in it.
>> >>> >
>> >>> > It took me until I was ready to post an angry message pointing at
>> >>> >
>> >>> >
>> >>> > http://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/
>> >>> > to finally realise it wanted me to type the *package* name.
>> >>> >
>> >>> > I think the form should have the field label "Name" replaced with
>> >>> > "Package Name", to make life easier for klutzes like myself :-)
>> >>> >
>> >>> > Regards,
>> >>> >   Tony
>> >>> > ____________________
>> >>> >   Racket Users list:
>> >>> >   http://lists.racket-lang.org/users
>> >>>
>> >>>
>> >>>
>> >>> --
>> >>> Jay McCarthy <jay at cs.byu.edu>
>> >>> Assistant Professor / Brigham Young University
>> >>> http://faculty.cs.byu.edu/~jay
>> >>>
>> >>> "The glory of God is Intelligence" - D&C 93
>> >>> ____________________
>> >>>   Racket Users list:
>> >>>   http://lists.racket-lang.org/users
>> >>
>> >>
>> >>
>> >> ____________________
>> >>   Racket Users list:
>> >>   http://lists.racket-lang.org/users
>> >>
>> >
>> >
>> >
>> > --
>> > --
>> > Jens Axel Søgaard
>> >
>>
>>
>>
>> --
>> Jay McCarthy <jay at cs.byu.edu>
>> Assistant Professor / Brigham Young University
>> http://faculty.cs.byu.edu/~jay
>>
>> "The glory of God is Intelligence" - D&C 93
>
>
>
>
> --
> --
> Jens Axel Søgaard
>



-- 
Jay McCarthy <jay at cs.byu.edu>
Assistant Professor / Brigham Young University
http://faculty.cs.byu.edu/~jay

"The glory of God is Intelligence" - D&C 93


Posted on the users mailing list.