Topic
4 replies Latest Post - ‏2013-03-21T00:06:57Z by BruceMacIsaac
SystemAdmin
SystemAdmin
1193 Posts
ACCEPTED ANSWER

Pinned topic Advice on 3 Person Team Authoring Content and Process

‏2013-02-18T19:26:16Z |
Hi:
Our Team has 3 people doing RMC Authoring.

We have a Network Drive, but no version control system (long story).

How would you recommend we structure our workspace\library\plugins?

I was thinking:
1 - Create a Method Library in Z:\SDLC\Org SDLC (This is a network drive)
2 - Everyone opens this Method Library
3 - Jane Created Plugin Jane in Z:\SDLC\Org SDLC\Jane Work\Plugins
4 - Abdul Creates Plugin Abdul in Z:\SDLC\Org SDLC\Adbul Work\Plugins
5 - Ming Creates Plugin Ming in in Z:\SDLC\Org SDLC\Ming Work\Plugins
6 - Ming Create Plugin Org Plugin in in Z:\SDLC\Org SDLC\Plugins
7 - Each Team member Works on each part of the plugin Content Packages, Example: BAs, Archits, Coders, Testers, PMs
8 - Ming (The Lead Author) creates Categories, and Processes in Org Plugin.

Will this work?

Feel free to propose other options, as long as it supports use of a network drive, and diff authors working on diff parts of the process, but somehow being able to create a published sites that include all method and process.

Thanks,
Rui Pereira
Updated on 2013-03-21T00:06:57Z at 2013-03-21T00:06:57Z by BruceMacIsaac
  • SystemAdmin
    SystemAdmin
    1193 Posts
    ACCEPTED ANSWER

    Re: Advice on 3 Person Team Authoring Content and Process

    ‏2013-02-21T10:15:12Z  in response to SystemAdmin
    Bump.

    Can anyone please help?
  • SystemAdmin
    SystemAdmin
    1193 Posts
    ACCEPTED ANSWER

    Re: Advice on 3 Person Team Authoring Content and Process

    ‏2013-02-21T16:09:04Z  in response to SystemAdmin
    This won't work, as you can't have manual sub-directories within a Library directory.

    You could have a Jane, Abdul, Ming, & Org plugin all in z:\sdlc\org sdlc\ ... however this may lead to problems with circular plugin references and may also not keep content organized by domain or practice which is better plugin architecture.

    You could probably solve the issue of circular references by having a base and assign plugin for each author. Where each assign plugin references the base plugins of the other authors. A pattern that you will see in the IPL (IBM Practice Library). The Org plugin could refer to all other plugins.

    I would recommend that you divide up the content by domain, e.g. Jane does BAs & Testers, Abdul does Arch & Coders, Mind does PMs. But then, it begs the question why even have plugins named by author. They could be named by domain and the team just knows which plugin belongs to whom.

    You are right to only have one author working on a given plugin at one time. Some communication can make this happen. Also, keep in mind you can use RTC as an SCM tool for RMC, and it's free for up to 10 people. All you need is a server to put it on. RTC now provides appropriate locking to allow multiple authors to work on the same plugin.

    Carson
    carson@software-development-experts.com
  • BruceMacIsaac
    BruceMacIsaac
    59 Posts
    ACCEPTED ANSWER

    Re: Advice on 3 Person Team Authoring Content and Process

    ‏2013-03-21T00:02:51Z  in response to SystemAdmin
    Yes, if you are using a workspace-based library, with each plug-in in its own eclipse project, you can use a file structure on a network drive as you have proposed.
    As long as each plug-in only has one person working on it, this should work.

    However, you said "Each Team member Works on each part of the plugin Content Packages".
    If this means two people making changes in the same plug-in, that is NOT a good idea.

    An alternative way of working is to have each person create a workspace consisting of content from the shared network drive that they are NOT working on, and plug-ins on their local drive that they alone work on. This means you are only reading from the network drive, and writing to your local drive. You can periodically copy your updated plug-ins to your network drive folder. The benefit of this is:
    • you can make snapshots of your plug-ins before copying to the network drive
    • you may get better performance since all your writes are local.

    It would be interesting to know how it works out for you. Please post a message to this forum when you've settled on an approach and have some experience to report.

    Bruce MacIsaac
    Manager RMC content
    • BruceMacIsaac
      BruceMacIsaac
      59 Posts
      ACCEPTED ANSWER

      Re: Advice on 3 Person Team Authoring Content and Process

      ‏2013-03-21T00:06:57Z  in response to BruceMacIsaac
      One quick follow-up. If you need more than one person working in the same plug-in, what CAN work is one person doing all the structural changes (adding, moving, deleting, and renaming elements), as well as all brief description and name/presentation name changes. These changes affect the plugin.xmi file. Other authors can work on the rich text in individual elements. Still, I would consider this risky, and instead I would suggest each person work in their own plug-in and then have one person merge the plug-ins later if the desired end result is a smaller set of plug-ins.

      Bruce MacIsaac