[documentation] [Documentation task] Should I develop against the stable version or HEAD?

[webchick]

Issue status update for 
http://drupal.org/node/80302
Post a follow up: 
http://drupal.org/project/comments/add/80302

 Project:      Documentation
 Version:      <none>
 Component:    Admin Guide
 Category:     tasks
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  webchick
 Updated by:   webchick
 Status:       active

Good point, sepeck. I forgot about that page. But that seems it's more
geared more toward people downloading Drupal for the first time. I'm
more addressing this towards site architects who want to build their
site on Drupal but need some guidance on which one to go with. They
could probably be merged into the same doc, or at least one pointing to
the other.


Zirafa: thanks, good points. :) I'll try and brainstorm some others,
too.




webchick



Previous comments:
------------------------------------------------------------------------

Wed, 23 Aug 2006 19:54:57 +0000 : webchick

This question has come up increasingly in the forums and IRC recently,
with all the buzz that's been going on about the installer, etc. and I
remember it also coming up a lot during the HEAD => 4.7 release cycle.


It would be great to get the pros/cons of this documented for once in
the handbook so we can refer people to that page.


We could maybe start with some of the stuff in this reply:
http://drupal.org/node/79006#comment-145788


But I'm thinking this probably needs to be fleshed out more, to go into
more detail.


Anyone have some feedback they'd like to put here? (especially would be
interesting coming from people who were building sites at the time of
the HEAD => 4.7 release cycle, both the "victims" ;) and those for whom
it was made easier.)




------------------------------------------------------------------------

Wed, 23 Aug 2006 21:45:02 +0000 : sepeck

You mean more then is already documented here?
http://drupal.org/handbook/version-info


We could add to that page the stuff about code freeze and something
nice and polite that says 'if you have to ask' then you shouldn't use
HEAD. 


It makes the page long but with versioning and such I'd rather it be in
one place for one referal link.




------------------------------------------------------------------------

Wed, 23 Aug 2006 22:54:03 +0000 : zirafa

My personal preference is to develop against the last stable version. 
However, I try and keep up with changes in HEAD and make a note of what
I'll have to do to upgrade.  That way when HEAD branches I already have
digested the things to do (for the most part).  I can understand why
some like to keep up with HEAD though.  It doesn't seem like one way is
really 'better' than the other, though.




------------------------------------------------------------------------

Wed, 23 Aug 2006 22:59:04 +0000 : zirafa

Keeping up with HEAD:


PROS:



* stay on top of changes
* less work per change
* early release time

CONS:



* it takes effort to constantly check for changes
* possibility of things breaking
* harder to troubleshoot problems?

Waiting for the stable branch:
PROS:



* easier to debug
* no work required to keep up with changes

CONS:



* if you wait till the end, you may have TONS of changes to make all at
once (i.e. form API!)
* there may be so many changes to make it pushed back your development
considerably (almost to the next cycle)