[racket-dev] Package system quickstart section?

From: Jay McCarthy (jay.mccarthy at gmail.com)
Date: Sun May 12 15:25:05 EDT 2013

The search is an error with some sort of out date index. I'm not sure
how to change what's on that server though...

On Sun, May 12, 2013 at 1:22 PM, Greg Hendershott
<greghendershott at gmail.com> wrote:
> 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



-- 
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.