[General] Wiki for developers

[Ted Leung]

On Jun 26, 2007, at 10:54 AM, Mimi Yin wrote:

> Okay, so are you proposing we deprecate For Developers and focus on  
> having a Developer Wiki Area?

I think it's more like, rename Engineering Area to Developer Area and  
make For Developers links point to that.

> Sounds like something you and Ted should take over?

I'm happy to work with Katie on this.

Ted

>
> On Jun 26, 2007, at 10:17 AM, Katie Capps Parlante wrote:
>
>> Mimi Yin wrote:
>>> *Engineering Area: *http://chandlerproject.org/Projects/ 
>>> EngineeringArea
>>> + *Open issue: How is what's on this page different from For  
>>> Developers? *- KATIE / TED / PHILIPPE?
>>> - http://chandlerproject.org/Journal/ForDevelopers
>>
>> What is different? Not much. The cosmo side pulled from the same  
>> sources on both pages.
>>
>> Here are my current thoughts...
>>
>> - The purpose of the "engineering" wiki area is for developers:  
>> core developers working on the project, developers who might  
>> contribute a patch or two, developers who want to use the server  
>> for CalDAV testing, developers who want to write desktop plugins,  
>> developers who want to write applications that pull data from the  
>> server using Atom or some other protocol, developers writing  
>> automated tests, etc.
>>
>> - The "engineering area" home page is a starting point for any of  
>> these people. It needs a brief description/overview of the server  
>> and destop, and needs obvious links to this information:
>>    * finding core developers (irc, mailing lists, etc.)
>>    * getting source (and building, etc.)
>>    * getting more technical info (architecture docs, protocol  
>> specs, etc.)
>>    * logging bugs and getting involved with testing
>>    * finding information about sub-components or projects
>>
>> - We could also add a "hacking" link for each project -- info for  
>> getting started coding that is aimed at someone new to the  
>> project. That assumes that a "hacking" page includes useful  
>> information not redundant to the above.
>>
>> - We could have a "project dashboard" page for both server and  
>> desktop, focused around release management: bug lists, links to  
>> tinderboxes, links to planning pages for current release, etc.
>>
>> - The open source license needs to be clearly identified
>>
>> I don't think we need an exact equivalent of the original desktop  
>> "for developers" page -- that was a short term solution for a  
>> particular release.
>>
>> I think the main page for the twisted project is a good example of  
>> tone and level of information: http://twistedmatrix.com/trac/.  
>> (Most people interested in twisted are developers).
>>
>> Also, I wonder if "Engineering" is the wrong term -- perhaps we  
>> should go with "Developer Area".
>>
>> Cheers,
>> Katie
>>
>> _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
>>
>> Open Source Applications Foundation "General" mailing list
>> http://lists.osafoundation.org/mailman/listinfo/general
>
> _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
>
> Open Source Applications Foundation "General" mailing list
> http://lists.osafoundation.org/mailman/listinfo/general