Release Automation

  • 1.  What's New in the RA Documentation

    Broadcom Employee
    Posted Jul 17, 2015 05:43 PM

    With 5.5.2 recently released, now is a good time to post a summary of what we're doing to continuously improve the Release Automation documentation. Here is a list of improvements we've made during the 5.5.1 and 5.5.2 cycles (in addition to adding content for new features):

     

    Content Improvements

    • New and improved documentation is available for configuring SSL communications between components.
    • Dozens of smaller improvements have been made on demand based on customer and stakeholder feedback. On our wiki platform, these updates can be published instantaneously between releases. Recent updates include fixes to LDAP integration, improvements to upgrade procedures, supported platform updates, improved action descriptions, better plugin deployment and usage documentation, and more! Watch the entire wiki or targeted pages to be notified when updates occur.
    • New and improved documentation is available for working with action packs and plugins.
    • Several recent action pack releases include fully documented example shared components. Example: JBoss Shared Component Workflow Examples.

    Usability Improvements

    • We performed a restructuring of all action pack and plug-in documentation into a new Integrations section. All action pack and plug-in documentation should be easier to find, and you will notice multiple improvements in the structure, content, and overall usability.
    • We made 'under the hood' changes to our content that significantly increases the performance of the wiki site. You should notice a reduction in page load time for integration documentation.
    • All help links in the product UI now point to online wiki pages. This ensures that you are always being directed to the latest content.
    • The documentation is now available without a login. In addition to being a convenience, it also means that the RA documentation will now appear in Google search results.

    Content Additions:

    • New Best Practices documents are available that add a significant amount of depth to our content. These are a result of collaboration with the RA SWAT team, who authored the content. In addition to these great documents being available in the community, they are now fully integrated into our wiki documentation. For an example, see Tokens Best Practices. We have more of these on the way, so please provide feedback if you think these are worthy additions to the doc.
    • New articles contributed by the RA Support team. Example: Working with Log Files. Again, more of these in the pipeline, and feedback/requests are welcome.

     

    The RA doc team is working very hard to improve the documentation, and we hope you are seeing benefits from the improvements we have implemented. The team is very receptive to feedback, so please interact either by replying to this message, commenting on wiki pages, or reaching out to me directly.

     

    Thanks,

    Archer Berryman

    Information Architect, CA Release Automation

    archer.berryman@ca.com



  • 2.  Re: What's New in the RA Documentation

    Posted Jul 23, 2015 01:59 AM

    Hi, just a small feedback to one of the sites, because we stumbled over it yesterday: https://wiki.ca.com/display/RA55/How+to+Create+and+Install+Custom+Actions

     

    The Install part doesn't apply anymore for 5.5.x (at least when using ROC) , there is a simple "import" button withn ROC under the action management. We didn't see this one before and were a bit confused, as we didn't have the "customActions" folders for example and weren't sure if we need to create it or if we're missing something

     

    Besides that I really like the documentation and especially doing it in a wiki.



  • 3.  Re: What's New in the RA Documentation

    Broadcom Employee
    Posted Jul 28, 2015 10:45 AM

    Michael,

     

    Thanks for this feedback. We will look into it and get it fixed. The great thing about our current doc platform is that we're no longer bound by GA dates; we can now make updates continuously throughout the cycle.

     

    Thanks,

    Archer



  • 4.  Re: What's New in the RA Documentation

    Posted Jul 31, 2015 03:20 AM

    Hi Archer,

     

    I was just wondering and I didn't see it yet. Is there somewhere within the current documentation something like an entity relationship diagram for the ca database tables?

     

    thanks,

    michael



  • 5.  Re: What's New in the RA Documentation

    Posted Jul 31, 2015 09:47 AM

    Here here!!!  That would be a fantastic thing to add to the docs!!

     

    I understand that the Schema is fluid and may change, but having the major entity relationships documented would be fantastic for those of us who occasionally need to query the database directly



  • 6.  Re: What's New in the RA Documentation

    Broadcom Employee
    Posted Jul 31, 2015 05:25 PM

    I will take this back to the dev team and see what I can do. I very much appreciate the feedback and the additional detail from Chip.

     

    Thanks,

    Archer



  • 7.  Re: What's New in the RA Documentation

    Posted Sep 29, 2015 06:07 AM

    hi archer,

     

    any news on this one?

     

    just asking, because I could have needed it again today

     

    thanks,

    michael