Uploaded image for project: 'GENIVI Development Platform'
  1. GENIVI Development Platform
  2. GDP-207 New repository management strategy for GDP
  3. GDP-196

Document and create the communications for the new repo/branching/tagging/merge policies for GDP

    XMLWordPrintable

Details

    • Sub-task
    • Resolution: Done
    • Low
    • None
    • None
    • None

    Description

      Description

      This task track the effort of the following tasks:

      1. Document the new policies related with the new repository structure, highlighting the changes compared with the previous one.
      2. Create announcement for the coming change and considerations for users and contributors
      3. Change the instructions in GDP-ivi9 feature page and target board pages based on the new repository structure
      4. Transition has started: create announcement
      5. Change follow up: informative mail on Wednesday with an update about the change
      6. Create anouncement: the old repos are no longer available.
      7. Create blog post about the transition

      1.- Document new policies

      • Documented in the wiki, GDP management page the new policies to manage the repositories.
        • Use the readme file content as base.
        • The idea is to avoid details. In the wiki page we just want general policies.
        • Add a link to the readme file.
        • New repos howto
        • Merge policy

      2.- Create announcement: transition is coming

      The mail should include:

      • Background
        • Links to discussions
        • Why we do this change
        • Expected benefits and potential issues
      • How the transition will take place
        • timeline

      3.- Change instructions to build/run GDP-ivi9

      Instructions to build from scratch or download and run GDP-ivi 9 are affected by this change. Target board wiki pages and the feature page are affected:

      • GDP-ivi0 feature page
      • Target boards:
        • RPi2
        • QEMU
        • Porter
        • Minnowboard

      4.- Create announcement: transition has started

      Blog post sent on Tuesday May 31st, supported by a mail, announcing the start of the transition process, which should include:

      • Transition overview
      • Timeline
        • timeline
      • Expected impact
        • For maintainers
        • For contributors
          • Impact for PRs
        • For users
          • Impact for those who still want to sue the former repos
      • Link to new policies and instructions to work with the new repositories.
        • Links to instructions about how to run/build GDP for each target
      • Message to test the new repo.

      5.- Create a transition follow up communication (since there has been no issues, we skipped this step)

      GDP delivery team will send a mail on Wednesday June 1st to projects ML with a follow up of the process including the folllowing content:

      • Overview of the change
      • Highlights of the process so far
      • Remind that Thusrday June 2nd the former repos will be erased.
      • Reinforce the idea that there are people available to support you in the transition
      • Link to new policies and instructions of the new repositories

      6.- Create an announcement: former repos no longer available

      On Thursday June 2nd it should be announced that the transtition perios has finished.

      • Background and highlights of the transition
      • The former repos are already unavailable
      • Contact the delivery team in case you have a problem
      • Link to new policies and instructions of the new repositories

      7.- Create a blog post about the transition. Due to lack of issues, we shipped this task)

      Summarise the transition in a blog post including:

      • Problem we wanted to solve
      • Challenges we needed to face
      • Description of the new repository structure
        • Put as reference the former one
      • Consequences/benefits for maintainers, contributors and users. Expected results.
      • Description of the transtion process
      • Next steps and next chanllenges.

      Attachments

        Issue Links

          Activity

            People

              tom.pollard tom.pollard
              toscalix toscalix
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: