{"title":"Turning a Battleship: Migrating ServiceNow Documentation to Use DITA Keys","authors":"E. Kimber","doi":"10.4242/balisagevol28.kimber01","DOIUrl":"https://doi.org/10.4242/balisagevol28.kimber01","url":null,"abstract":"Describes the analysis, design, planning, and data processing ServiceNow used to migrate all of its DITA-based ServiceNow Platform product documentation from the use of unmanageable direct-URL references for all reuse references and hyperlinks to the use of key-based indirect linking within and among publications. The technical solution uses DITA keys for all links, including use of DITA’s “cross deliverable” linking feature, which enables authoring links from one publication to another (similar to DocBook’s cross-book links but with different implementation challenges). Focuses on the XSLT and XQuery migration process used to perform the migration over a four-day period in the pause between semi-yearly product releases.","PeriodicalId":89326,"journal":{"name":"Balisage series on markup technologies","volume":"1 1","pages":""},"PeriodicalIF":0.0,"publicationDate":"1900-01-01","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"70947719","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
{"title":"The Secret Garden","authors":"B. T. Usdin","doi":"10.4242/balisagevol28.usdin01","DOIUrl":"https://doi.org/10.4242/balisagevol28.usdin01","url":null,"abstract":"We in the markup community have built ourselves a beautiful and ever-improving place to work. We can move content into markup, we have a variety of tools to manipulate marked-up content, we can move at will from tool to tool, we create a variety of products from that marked up content, and we believe our marked up content will be long lived. We frequently lament that most of the world doesn’t live in our techno-garden, and we occasionally admit that most of the world doesn’t even know it exists. At Balisage this year we will learn about ways in which our technology is improving. We will hear about some of the projects we are doing with markup and some of the problems we are having. And we will hear (a little) about how we are opening the gate to our garden and interacting with the outside world.","PeriodicalId":89326,"journal":{"name":"Balisage series on markup technologies","volume":"1 1","pages":""},"PeriodicalIF":0.0,"publicationDate":"1900-01-01","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"70948050","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}