 |
 |
I am interested in the demo too. A webinar would be good. Thanks. Jenny Jenny Jing Information Systems Librarian Discovery Systems Queen’s University Library Kingston ON, K7L 5C4 [log in to unmask] 613-533-6000 x 75302 -----Original Message----- From: Code for Libraries [mailto:[log in to unmask]] On Behalf Of Doreen Herold Sent: April-09-15 4:12 PM To: [log in to unmask] Subject: Re: [CODE4LIB] Managing internal documentation Hi Gary, I'd be interested in a demo of it. And I think I have a couple of staff that would also be inspired by your model. I wonder if that could be a good webinar to provide? Does CODE4LIB ever host such events? Doreen On Thu, Apr 9, 2015 at 3:32 PM, Gary Thompson <[log in to unmask]> wrote: > The Digital Initiatives and IT (DIIT) department at the UCLA Library > transformed the way we work over the last 6 years after implementing > Confluence. We've got two teams of developers (3 focused on the > Digital Library, 6 on everything else), a team of 4 Digital Library > project managers, and an operations staff of 18,; we all rely on the > wiki. It has proved essential after a couple of recent staff departures. > > Confluence supports the basic wiki model of linked and tagged > documents, but allows people who like to hierarchy to organize content > in a tree. We make heavy use of the /metadata-list/ macro to format > the structure, and generate views or lists of content (e.g., lists of > serves, vendors, projects, etc) controlled by labels (i.e., tags) > using the /metadata-report/ macro. We use tagging to indicate project > status (definition, planning, execution), type of content > (server-logs, specifications), or technology (voyager, drupal). > > We're running our own service; Atlassian on-demand was not an option > when we started. If we weren't using local LDAP authentication, we > might consider migrating to a hosted service. I suspect that we will > eventually move to hosted Confluence, but it's not currently a priority. > > The wiki became so integral to the way we work that we decided to > replace our old ticketing system (FootPrints) with Jira to take > advantage of the integration. > > Our DIIT implementation was so successful that other Library > departments and locations are starting to use it, some in very > sophisticated ways. For example, a cross-department digitization team > uses it to accept requests, prioritize the work, and track progress. > > I would be happy to show anyone who is interested how we use it. A > colleague and I considered writing a Code4Lib Journal article on our > project management methodology, but that article didn't get focus. > This question -- and my answer -- may motivate me to get it done. > > Cheers, > > /-- -- Gary Thompson > -- Head of Software Development & Project Management > -- Digital Initiatives & Information Technology > -- UCLA Library > -- 390 Powell > -- voice: 310.206.5652 > --/ > > > > On 4/9/2015 11:40 AM, Scott Williams wrote: > >> Apologizes for cross-posting >> ### >> >> Hi all -- >> >> We are investigating several software platforms for creating and >> managing internal documentation and wanted to see what experiences >> others have had with these packages. >> >> We are evaluating >> * MadCap Flare >> * Adobe RoboHelp >> * Confluence >> >> Our initial goals for these systems are to replace or augment our >> existing documentation strategy, which is a mix of private Google >> sites, SharePoint and Word docs. We are starting with our IT >> department but hope to include other user groups over time. >> >> Things we like: >> * SVN control with MapCap and RoboHelp. However, we have run into >> problems with both of their implementations >> * Write once publish everywhere functionality >> * HTML5 support with WebHelp Plus >> * Context aware searching >> * Easily export and share documentation externally (PDF) >> * Consistent theming and styling across all the documentation >> * User/group security management for hiding more sysadmin >> documentation >> >> Things we don't like >> * Windows only (MadCap and RoboHelp) >> * WebHelp requires IIS (?) >> * Limited functionality with the hosted version of Confluence >> >> >> What are people using to manage their internal >> systems/architecture/application documentation? Are there other >> products we should be considering? >> >> Many thanks, >> Scott >> >> ---- >> Scott Williams >> Data & Database Administrator >> Yale University Art Gallery >> > -- Doreen Herold Manager, Library Technical Services Lehigh University Library & Technology Services 30 Library Drive - Bethlehem, PA - 18015 610.758.3040 - [log in to unmask] http://library.lehigh.edu Library Technical Services Wiki <https://confluence.cc.lehigh.edu/x/SQAR>