Update and Version Management

1. Update and Version Management Joint Course on Software Engineering Klaus Bothe 3rd Workshop Software Engineering Education and Reverse Engineering, Ohrid, Macedonia, 2003 Institute of Informatics, Humboldt University – Berlin, Germany, bothe@informatik.hu-berlin.de Update and Version Management

2. Joint Course on Software Engineering • Update management • Version: 14 July 2003-07-14 • Author: Klaus Bothe • 1. Unique current topic files: • For each topic, there is only one current ppt slide file which is located at the SE education website of HU. • Only one modifier of a topic file at one moment: •   At one moment, only one party is allowed to modify the current topic file.  • Technical modification procedure: • Agreement of a topic modification between the modifier and the project manager. • The current topic file has to be marked by “in update by ‘modifier’ s name’” (done by the website administrator). • After the modification, the website administrator physically exchanges the old current topic file by the modified current topic file. Update and Version Management

3. 4. Save old topic versions: • Two old topic versions should be saved by the website administrator (Should they also be accessable from the SE website by a link?). • Version identification: •   A version has to be be uniquely identified by its date (on the title slide of the topic). • Documentation of modifications: • The lecture notes of the title slide have to capture all (important) modifications with respect to the previous version. • Reference to a modified slide should be done by its slide number and its slide title (slide numbers can change, slide titles should be unique). • 7. Release intervals: • To have a common basis of discussion, versions should not be released so often (each some months, half a year). Update and Version Management

4. updates updates updates ^_^ ^_^ ^_^ 1. Unique current topic files Joint Course Website personal copy Topic 5c Topic 5b Topic 5a Topic 5 current topic file Update and Version Management

5. ^_^ ^_^ ^_^ ^_^ 2. Only one modifier of a topic file at one moment personal copy Joint Course Website Topic 5c Topic 5b modifier A Topic 5 Topic 5a current topic file current topic file in modification Update and Version Management

6. step 3b: exchange Topic 5 by Topic 5a step 2b: mark topic step 3a: modification finished step 2a: request ^_^ ^_^ ^_^ 3. Technical modification procedure Joint Course Website current topic file current topic file in modification Topic 5 in update by A Topic 5a step 1: agreement modifier A website administrator project manager Update and Version Management

7. 4. Save old topic versions: • Two old topic versions should be saved by the website administrator (Should they also be accessable from the SE website by a link?). • Version identification: •   A version has to be be uniquely identified by its date (on the title slide of the topic). • Documentation of modifications: • The lecture notes of the title slide have to capture all (important) modifications with respect to the previous version. • Reference to a modified slide should be done by its slide number and its slide title (slide numbers can change, slide titles should be unique). • 7. Release intervals: • To have a common basis of discussion, versions should not be released so often (each some months, half a year). Update and Version Management

8. ^_^ ^_^ ^_^ Flexibility: the current topic file in modification can move new modifier current topic file in modification Joint Course Website 5a Topic 5c Topic 5b modifier personal copy Topic 5 Topic 5a current topic file current topic file in modification Update and Version Management

9. Update management: dependence on the topic maturity and topic usage (1) Development phase: • a lot of errors and shortages of the material • only a few lectures based on the material • recommendations for improvements will come only from a few parties • the update process is easy to coordinate Update and Version Management

10. Update management: dependence on the topic maturity and topic usage (2) Consolidation phase: • more stable versions • several parallel lectures • recommendations for improvements will come from different parties • the update process has to be coordinated more carefully Review reports: • collect remarks and suggestions • There is no full-time job person that can immediatly modify the topic according to the remarks and suggestions. Update and Version Management

11. Review report Review report Review report ^_^ ^_^ ^_^ Use of review reports for the update management Joint Course Website Proposals for new slides Topic 5c Topic 5b Topic 5a Modifications of topic 5 have to be agreed between the review report authors and the project manager Topic 5 Update and Version Management