On 7/15/07, Marc Garcia <[EMAIL PROTECTED]> wrote:
>
> Is there any django development documentation? I couldn't find any
> document on how to start writting my own django add-on.

All the documentation that exists is either in the Django source tree
under /docs (which is what is displayed at
djangoproject.com/documentation), or in the Wiki. There isn't really
anything specifically directed at developers, other than the 'how to
contribute' page.

> Thinks that I want to learn are:
> * how to create my own field (based on other django fields, or in sql
> fields not still used; probably the latter is too much complicated,
> according to django multidb feature).

This has been recently discussed - both that the procedure should be
documented, and that in documenting the procedure, the need for some
cleanup of the underlying code may be revealed. Any suggestions are
welcome.

> * how to define it's html code in admin.

Any changes/suggestions here should be made against the newforms-admin
branch. The admin application is currently being rewritten to take
advantage of the newforms library, which governs how fields are
rendered as HTML.

> * how to create my own tag template.

This is partially covered in docs/templates_python, but any
suggestions on how to improve this would be welcome.

> I think that this documentation will be good for unifiing development
> styles. I'll work on it while learning, if nothing still exists.

Getting the first draft of any document is always a difficult step, so
any contributions to documentation are always welcome. Documentation
that stems from newcomer experience (i.e., here's what I didn't know
when I started) is also valuable - the core developers play with this
code regularly, and familiarity can lead to use forgetting what may
(or may not) be obvious.

Adrian casts his editorial pencil over any submissions to
documentation (even submissions from the other core developers).
However, this is one of the reasons that Django's documentation is as
good as it is. Don't be discouraged if Adrian tears your first draft
to shreds - it happens to all of us :-)

Yours,
Russ Magee %-)

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"Django developers" group.
To post to this group, send email to django-developers@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/django-developers?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to