Re: Online Documentation
Re: Online Documentation
- Subject: Re: Online Documentation
- From: "Peter Karlsson" <email@hidden>
- Date: Wed, 25 Jun 2003 11:01:52 +0000
Hi Oliver!
I think this is a VERY good ide. I really like the examples section
Example 1. fopen() examples
For a newbie like me that would save me a lot of emails to the Cocoa list.
Peter
From: Oliver Donald <email@hidden>
To: "'email@hidden'" <email@hidden>
Subject: Online Documentation
Date: Wed, 25 Jun 2003 11:05:52 +0100
I think we need something more organised than a FAQ for a subject as large
as Cocoa. I use a few documentation sites for various things, and my
favourite by a long way is the PHP manual at http://www.php.net. For each
function you have nicely formatted manual entry, but then you have lots of
user contributions listed afterwards (see the 'fopen' example
http://uk.php.net/manual/en/function.fopen.php).
I think that a Cocoa 'manual' layed out like this would be incredibly
useful. Have sections for each object, and then subpages for the object's
methods. For each method list the standard Apple documentation, but a
little
more standardised, ie, wether or not objects returned are autoreleased,
wether data is copied or referenced, stuff like that that confuses noobs
like me.
After that people can post their tips/tricks/pitfalls/general comments etc
etc. These comments could even rated.
Any thoughts?
DISCLAIMER: The information contained in this e-mail is confidential and
may
be privileged. It is intended for the addressee only. If you are not the
intended recipient, please delete this e-mail immediately.
The contents of this email must not be disclosed or copied without the
sender's consent. We cannot accept any responsibility for viruses, so
please
scan all attachments.
The statements and opinions expressed in this message are those of the
author and do not necessarily reflect those of the company. The company
does
not take any responsibility for the views of the author.
_______________________________________________
cocoa-dev mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/cocoa-dev
Do not post admin requests to the list. They will be ignored.
_________________________________________________________________
Tired of spam? Get advanced junk mail protection with MSN 8.
http://join.msn.com/?page=features/junkmail
_______________________________________________
cocoa-dev mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/cocoa-dev
Do not post admin requests to the list. They will be ignored.