emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Adam Porter <adam@alphapapa.net>
To: emacs-orgmode@gnu.org
Subject: Org should follow SemVer conventions [Was: Automatically save the archive file after org-archive-subtree]
Date: Tue, 09 Oct 2018 01:05:00 -0500	[thread overview]
Message-ID: <87tvlv4pv7.fsf@alphapapa.net> (raw)
In-Reply-To: f74fce15-c2ea-048e-b2ef-7ad40e717c89@arfer.net

Kodi Arfer <kodi@arfer.net> writes:

> As of
>
> https://code.orgmode.org/bzg/org-mode/commit/b186d1d7236c0dc397eadeb004c9a17eaffd3aab
>
> archiving a subtree no longer automatically saves the archive
> file. How can I get this behavior back?
>
> A Debian bug was also opened for this issue:
>
> https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=887332

According to that bug report, the behavior changed when upgrading from
9.1.2 to 9.1.5.

I think this shouldn't happen.  "Patch"-level releases (incrementing the
third number) should only contain bug fixes.  Changes which change
default behavior belong in, at minimum, "minor" releases (incrementing
the second number).

Users should be able to freely upgrade from 9.1.x to 9.1.x+1 without
having to worry about reading a changelog and adjusting their config to
avoid changes in behavior which could lead to data loss.

In my own (much smaller) projects, I follow this practice, which is
basically SemVer.  When I fix bugs, I apply the fixes to the latest
stable branch, make a new stable patch-level release, and then merge the
fixes into the master branch (in some projects, by rebasing the master
branch on top of the stable branch, and in others, by a non-fast-forward
merge of the stable branch into the master branch).  The master branch
becomes the next stable branch when its new features and other changes
have been merged for long enough and have no known bugs.

New features and refactorings are generally developed in a feature
branch and then merged into the master branch when ready, eventually
being released in the next stable branch.

The master branch is intended to be always usable, but only recommended
to users who are willing to potentially encounter bugs in new features
or as a result of other significant changes.  (In practice, this ends up
being the branch used by 99.9% of MELPA users, but that's a
MELPA-specific issue.)  Most users should use the latest stable branch.

This practice also makes it much easier for downstream packagers, like
Debian, because changes to the stable branch are ONLY bug fixes.

Could Org start doing this and call it Org 10.0?

  reply	other threads:[~2018-10-09  6:05 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-10-06 15:24 Automatically save the archive file after org-archive-subtree Kodi Arfer
2018-10-09  6:05 ` Adam Porter [this message]
2018-10-09  6:49   ` Org should follow SemVer conventions [Was: Automatically save the archive file after org-archive-subtree] Nicolas Goaziou

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87tvlv4pv7.fsf@alphapapa.net \
    --to=adam@alphapapa.net \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).