[racket-dev] Package system quickstart section?

From: Greg Hendershott (greghendershott at gmail.com)
Date: Sun May 12 15:22:39 EDT 2013

Just to confirm what I mean, the live/public
http://docs.racket-lang.org/ site right now has links to the
non-existent /planet2/* tree.

For example if you do a Search Manuals for "raco pkg", which gives this page:

http://docs.racket-lang.org/search/index.html?q=raco%20pkg

Then the first of two results is:

    raco pkg  in planet2

And both the "raco pkg" and "planet2" links go to /planet2/* and 404.
(Plus it sounds like the second, topic link should be labeled
something other than "planet2", such as "pkg" or "Package
Management".)


On Sun, May 12, 2013 at 3:13 PM, Jay McCarthy <jay.mccarthy at gmail.com> wrote:
> Yes, the documentation file was renamed before the last release. This
> new name is stable.
>
> On Sun, May 12, 2013 at 1:06 PM, Greg Hendershott
> <greghendershott at gmail.com> wrote:
>> BTW all of http://docs.racket-lang.org/planet2/* is 404 for me. The
>> help index is linking to that.
>>
>> It looks like all that is actually under http://docs.racket-lang.org/pkg/* ?
>>
>> e.g.:
>> http://docs.racket-lang.org/planet2/Package_Concepts.html   => 404
>> http://docs.racket-lang.org/pkg/Package_Concepts.html        => OK.
>>
>>
>> On Wed, May 8, 2013 at 10:38 AM, Jay McCarthy <jay.mccarthy at gmail.com> wrote:
>>> There currently is a quickstart section designed for developers:
>>>
>>> http://docs.racket-lang.org/planet2/Developing_Packages.html
>>>
>>> So, I'm fine with you working on a quickstart from a user perspective,
>>> although I worry about being too vague on some of the details in the
>>> Concepts section or duplicating the content. At a high-level, go for
>>> it, but I'd like to see what you make.
>>>
>>> Jay
>>>
>>> On Wed, May 8, 2013 at 6:56 AM, Asumu Takikawa <asumu at ccs.neu.edu> wrote:
>>>> Hi all,
>>>>
>>>> Would anyone be opposed to adding a "Quickstart" section to the Package
>>>> System documentation page? The current first section[1] is useful, but
>>>> it's a pretty dense read for someone who just wants to know how to
>>>> install a package.
>>>>
>>>> I'm imagining that the Quickstart would describe where to find packages
>>>> (pkg.racket-lang.org, github, etc.) and the commands you need to type to
>>>> install a package from typical sources. Maybe screenshots showing how to
>>>> use the package GUI.
>>>>
>>>> [1]: http://docs.racket-lang.org/planet2/Package_Concepts.html
>>>>
>>>> Cheers,
>>>> Asumu
>>>> _________________________
>>>>   Racket Developers list:
>>>>   http://lists.racket-lang.org/dev
>>>
>>>
>>>
>>> --
>>> 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 Developers list:
>>>   http://lists.racket-lang.org/dev
>
>
>
> --
> 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 dev mailing list.