A note: Do not debate these rules on the list. Direct emails to the admins 
address listed below and in every posting. This includes the moderator and the 
people who actually own the list.

These guidelines are in addition to the general Apple mailing list Terms and 
Conditions. If you are unable to abide by these guidelines then please 
unsubscribe now.


New Posters
===========

A reminder that people who post for the first time are moderated. Messages 
should be approved or rejected within 48 hours (usually much sooner). Once it’s 
clear that your posts are on topic and not violating the rules, the moderation 
bit is cleared. Also, messages over 25K are also moderated automatically. 
Typically HTML messages or images trigger this.

If your messages are automatically rejected the odds are that you’re posting 
from an email address that you are not subscribed with.

iPhone SDK
==========

Developers should be aware that any iPhone SDK greater than 4.0 is under 
non-disclosure (section 5.3 of the iPhone Development Agreement). It can't be 
discussed here. This includes other mailing lists, forums, services like 
Twitter, and blogs. Violating the NDA will result in WWDR being notified of the 
breach. Further action is at their (and legal's) discretion.

The Apple Developer Forums at http://devforums.apple.com are available for 
discussion of NDA software under certain situations. Please consult the forums 
for more information.

Copy Protection
===============

The discussion of copy protection is not appropriate for this list. Instead try 
the Mac Small Business list noted below.

Discussing Private API
======================

The discussion of Private API is also not appropriate for this list. Using 
private API is strongly discouraged as it can (and often does) change in future 
software revisions. If you feel some private API should be made public contact 
WWDR directly or file a bug using bugreporter.apple.com. Please do not advocate 
for those changes here, it isn't effective.

Additional Thread Moderation (new)
==================================

This has never had to be stated before, although it has been the case for years.

From time to time it necessary to moderate (close) threads that have gotten off 
topic, include undocumented or private API, or otherwise are inappropriate for 
this list. If you feel this is in error or heavy handed contact the list admins 
at cocoa-dev-admins(at)lists.apple. Complaining on the list may lead to 
moderation of your posting privileges. Being abusive _will_ result in 
moderation.

Please stay on-topic
====================

There are currently more than 8000 subscribers to this list and several hundred 
messages posted per day. In order to keep the list useful please stay on topic 
and stick to technical discussion.

If your message starts with OT: or Off Topic: do not hit send.

Cocoa-dev should not be the first place you turn when you encounter a problem. 
First you should:

 - Search the documentation in Xcode
   - Remember to select the appropriate doc set and, if applicable, turn on 
full text searching
 - Search the list archives at apple.com or cocoabuilder.com
   - Many questions have been asked repeatedly and good answers have already 
been provided. Check the archives _every time_.
 - Search Google
   - There are many Cocoa developers who blog about their experiences. This is 
a very useful resource.
 - Ensure that this is actually Cocoa related.
   - Basic C questions are not appropriate for this list.

If someone posts a message that is off-topic, please do not reply to the list.  
You should contact the sender directly or alert a moderator.  If a moderator 
flags a thread (typically with [Moderator] in the subject line), do not 
continue to post to that thread. Do feel free to contact the list admins at 
cocoa-dev-adm...@lists.apple.com with any issues.

If you post a message that is blatantly off-topic, you are liable to be 
moderated.

While Apple engineers often subscribe to the list and answer questions, they do 
so on a volunteer basis. This is not an official support channel, and you 
should not expect an Apple engineer to provide the answer. Instead contact 
<d...@apple.com> for technical issues.

To file bugs use bugreporter at http://bugreporter.apple.com




Other mailing lists
===================

**** Other Apple mailing lists that may be relevant are listed at:
        <http://lists.apple.com/mailman/listinfo>
in particular see:
        Xcode-users: <http://lists.apple.com/mailman/listinfo/xcode-users>

The Omni Group hosts a general Mac OS X developer list:
        <http://www.omnigroup.com/mailman/listinfo/macosx-dev>

There is a Yahoo Group for discussion of business-related issues at:
        <http://groups.yahoo.com/group/macsb/>



List etiquette
==============

When you post a message, bear in mind that you are asking several thousand 
people to listen to what you're saying. Please ensure that you abide by the 
list rules:

 <http://lists.apple.com/tc.html>
 <http://lists.apple.com/tips.html>
     In particular: please "Edit included messages in replies to
     minimize the amount of text."  There is no need, for example,
     to include the list footer in your reply.


**** Before posting a question, please check the list archives (see "Online 
resources" below) and try searching Google. Many questions have been asked 
before and have already been answered.

**** When you ask a question, whenever possible please:

        1. Describe what your high-level goal is
        2. Include any relevant code
        3. If appropriate, include URLs to screenshots


 If you post a message to the list and do not get a reply, you should not 
simply repost the message.
 There may be reasons why no-one has answered, see the references above.
 If you want to send again, add more information or background, or explain what 
further steps
 you have taken in the interim to solve your problem.

 Note that you should never post to the list any message that was sent to you
 privately unless you have the original author's permission.

Cocoa-related resources
=======================

Cocoa-related resources that may answer your question without the need to wait 
for a reply from the list:


Mac OS X Dev Center
-------------------

The main source for documentation is the Mac OS X Dev Center at
        <http://developer.apple.com/mac/>



Remember you can also view and search the documentation in Xcode -- see the 
"Help" menu.  You can see all the methods associated with a class (and links to 
relevant documentation) using Xcode's Class Browser (see the Project > Class 
Browser menu item).  In Xcode, you can Option-double-click on a symbol to look 
it up in the documentation, and you can Command-double-click on a symbol to go 
to the header file in which it is declared.


* Keeping documentation up-to-date

You can keep your local documentation up-to-date by using the Documentation 
update preference in Xcode.  Apple's developer documentation is updated en bloc 
about once a month.  An update package is made available at about the same time 
that updates are published on the web site.

Code examples
-------------

With few exceptions, sample code has bee moved to the Mac OS X Dev Center. This 
allows for more dynamic updates.

There are also numerous third party examples on the web. Google to find them.


Online resources
----------------

 Mac OS X Dev Center
 <http://developer.apple.com/mac/>

 List archives
 <http://lists.apple.com/archives/cocoa-dev>

 Combined Apple and Omni Cocoa developer list archives
 <http://www.cocoabuilder.com/>

 Cocoa-related sites
 <http://www.cocoadev.com/>
 <http://www.cocoadevcentral.com/>

 Google
 <http://www.google.com/>
 (It is sometimes the case that using the subject line of a post as a search 
term in
 Google will yield an answer.  If this is the case, you have probably not 
invested sufficient
 effort into finding an answer to your problem, and you are likely to receive a 
reprimand.)


Memory management
-----------------

Developers are strongly discouraged from attempting to reformulate Cocoa's 
memory management rules in posts to the list.  Almost invariably, someone makes 
a subtle or not-so-subtle mistake which then results in confusion and 
additional messages to resolve the issue.  Simply post links to the relevant 
documentation, such as:


        
<http://developer.apple.com/mac/library/documentation/Cocoa/Conceptual/MemoryMgmt/index.html>



_______________________________________________

Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)

Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com

Help/Unsubscribe/Update your Subscription:
http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com

This email sent to arch...@mail-archive.com

Reply via email to