build: Add staging directories for future changes.
authorBen Ford <bford@digium.com>
Wed, 27 Mar 2019 16:03:40 +0000 (11:03 -0500)
committerBenjamin Keith Ford <bford@digium.com>
Wed, 27 Mar 2019 18:32:54 +0000 (12:32 -0600)
commitd5d8448ce595ec446f1192155fd8a1feefa71b34
treed1cb982d7c082e37b8ca65ee64829e3eeb71c426
parent24facecdd094b34293d31c34f0e942a520b8d172
build: Add staging directories for future changes.

This is the first step in changing the release process so that changes
made to the CHANGES and UPGRADE.txt files do not result in merge
conflicts every time multiple people modify these files. The changes
made will go in these new directories: doc/CHANGES-staging and
doc/UPGRADE-staging. The README.md files explain how things will work,
but here's a little overview. When you make a change that would go in
either CHANGES or UPGRADE.txt, this should instead be documented in a
new file in the doc/CHANGES-staging or doc/UPGRADE-staging directory,
respectively. The format will look like this:

   Subject: res_pjsip

   A description that explains the changes made and why. The release
   script will handle the bulleting and section separators! The
   'Subject:' header is case-sensitive.

   You can still separate with new lines within your description.

   Subject: res_ari
   Master-Only: true

   You can have more than one subject, and they don't have to be the
   same! Also, the 'Master-Only' header should always be true and is
   also case-sensitive (but the value is not - you can have 'true' or
   'True'). This header will only ever be present in the master branch.

For more information, check out the wiki page:
https://wiki.asterisk.org/wiki/display/AST/CHANGES+and+UPGRADE.txt

This is an initial change for ASTERISK_28111. Functionally, this will
make no difference, but it will prep the directories for when the
changes from CHANGES and UPGRADE.txt are extracted.

Change-Id: I8d852f284f66ac456b26dcb899ee46babf7d15b6
doc/CHANGES-staging/README.md [new file with mode: 0644]
doc/UPGRADE-staging/README.md [new file with mode: 0644]