{"id":2877,"date":"2021-02-16T12:33:33","date_gmt":"2021-02-16T17:33:33","guid":{"rendered":"http:\/\/www.lios.ca\/?post_type=realisation&p=2877"},"modified":"2021-02-17T14:37:42","modified_gmt":"2021-02-17T19:37:42","slug":"documentation-for-a-jira-application","status":"publish","type":"realisation","link":"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/","title":{"rendered":"Documentation for a Jira application"},"content":{"rendered":"

Need<\/span><\/h2>\n

With their Checklist for Jira<\/a><\/span>\u00a0app, Okapya has developed one of the most popular tools on Atlassian Marketplace. As they were preparing to release an all-new version of Checklist, they also wanted to continue to better serve their users by taking the accompanying documentation to the next level. They envisioned creating online documentation that would present information in a user-friendly and balanced way, giving users all the information they needed without getting them bogged down in too much detail. They also wanted to provide various use cases that would showcase all that Checklist for Jira had to offer.<\/span><\/p>\n

Most importantly, it was vital for Okapya that the documentation be available when the new version of the app was released.<\/span><\/p>\n

Issue<\/span><\/h2>\n

To make all that happen, Okapya would have to overcome some significant hurdles \u2014 the first being that their developers already had their hands full developing the new version. And while it may seem counterintuitive, another challenge facing Okapya was that their developers knew their product backwards and forwards, which meant they weren\u2019t in the best position to explain how to use it. By this point, they had become such experts on their product that they had a tough time putting themselves in users\u2019 shoes and determining what information to share, and how.<\/span><\/p>\n

The Okapya developers also knew that to get the quality of documentation that they wanted for their users, they would have to call in experts. That\u2019s why they decided to approach the Lios team, who already had a proven track record in the industry.<\/span><\/p>\n

Approach<\/span><\/h2>\n

To create documentation that would do the Checklist app justice, Lios started by looking into what documentation worked best for other tools on Marketplace. As a result, they were able to assemble best practices that would guide them throughout the process of developing the documentation.<\/span><\/p>\n

Alongside the Okapya team, Lios then created the various help pages directly within Confluence, which would give everyone who was involved in the project access at all times, as well as a table to track the progress of each page. That way, Okapya could quickly answer Lios\u2019 questions and leave feedback on each chunk of content as soon as it was ready. This approach established a real dialogue between the teams, which kept things moving quickly. Additionally, the feedback from each side also gave the other side food for thought, which helped make the final documentation more relevant and useful.\u00a0<\/span><\/p>\n

Because the two teams had such an open line of communication, Lios was also able to provide feedback on the user interface while testing procedures. Since the technical writing team had the unique position of being both insiders and first-time users, they were able to capitalize on opportunities to make the interface more consistent and intuitive.<\/span><\/p>\n

For their part, the Okapya team also worked hard to set up an exceptional review process. By reviewing content and comments from a technical and marketing standpoint, Okapya made sure to send Lios a unique message.<\/span><\/p>\n

Meeting goals\u2026<\/span><\/h2>\n

By entrusting their documentation to Lios, Okapya was able to meet their goal. They provided their users with top-quality documentation that was ready to go the same day that the new version of the Checklist app was released.<\/span><\/p>\n

See for yourself what working with experts can do: Checklist for Jira – Server & Data Center Docs<\/a><\/span><\/p>\n

Are you a Jira user like us? Give Checklist for Jira<\/a> a try!\u00a0<\/span><\/p>\n

\u2026and setting new ones<\/span><\/h2>\n

In the end, Lios did much more than just produce documentation for Okapya. They also took the lead on implementing a solid structure and effective tools for updating the Checklist for Jira documentation going forward, which will prove useful as the app evolves and adapts to the various Jira hosting options (Cloud, Data Center, Server). And above all, Okapya can always count on Lios for advice or to review new content to add to the documentation. After all, Lios is just a message away on Slack.<\/span><\/p>\n","protected":false},"author":2,"featured_media":2866,"menu_order":2,"template":"","service":[16],"expertise":[17,19],"industrie":[20],"class_list":["post-2877","realisation","type-realisation","status-publish","has-post-thumbnail","hentry","service-content-development-en","expertise-manuals-and-online-help-en","expertise-technical-writing-and-documentation-en","industrie-software-and-technologies-en"],"acf":[],"yoast_head":"\nDocumentation for a Jira application - Lios<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Documentation for a Jira application - Lios\" \/>\n<meta property=\"og:description\" content=\"Need With their Checklist for Jira\u00a0app, Okapya has developed one of the most popular tools on Atlassian Marketplace. As they were preparing to release an all-new version of Checklist, they also wanted to continue to better serve their users by taking the accompanying documentation to the next level. They envisioned creating online documentation that would […]\" \/>\n<meta property=\"og:url\" content=\"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/\" \/>\n<meta property=\"og:site_name\" content=\"Lios\" \/>\n<meta property=\"article:modified_time\" content=\"2021-02-17T19:37:42+00:00\" \/>\n<meta property=\"og:image\" content=\"http:\/\/www.lios.ca\/wp-content\/uploads\/2021\/02\/lios-okapya-atlassian-entete.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1920\" \/>\n\t<meta property=\"og:image:height\" content=\"1080\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"http:\\\/\\\/www.lios.ca\\\/en\\\/realisation\\\/documentation-for-a-jira-application\\\/\",\"url\":\"http:\\\/\\\/www.lios.ca\\\/en\\\/realisation\\\/documentation-for-a-jira-application\\\/\",\"name\":\"Documentation for a Jira application - Lios\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.lios.ca\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"http:\\\/\\\/www.lios.ca\\\/en\\\/realisation\\\/documentation-for-a-jira-application\\\/#primaryimage\"},\"image\":{\"@id\":\"http:\\\/\\\/www.lios.ca\\\/en\\\/realisation\\\/documentation-for-a-jira-application\\\/#primaryimage\"},\"thumbnailUrl\":\"http:\\\/\\\/www.lios.ca\\\/wp-content\\\/uploads\\\/2021\\\/02\\\/lios-okapya-atlassian-entete.jpg\",\"datePublished\":\"2021-02-16T17:33:33+00:00\",\"dateModified\":\"2021-02-17T19:37:42+00:00\",\"breadcrumb\":{\"@id\":\"http:\\\/\\\/www.lios.ca\\\/en\\\/realisation\\\/documentation-for-a-jira-application\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"http:\\\/\\\/www.lios.ca\\\/en\\\/realisation\\\/documentation-for-a-jira-application\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"http:\\\/\\\/www.lios.ca\\\/en\\\/realisation\\\/documentation-for-a-jira-application\\\/#primaryimage\",\"url\":\"http:\\\/\\\/www.lios.ca\\\/wp-content\\\/uploads\\\/2021\\\/02\\\/lios-okapya-atlassian-entete.jpg\",\"contentUrl\":\"http:\\\/\\\/www.lios.ca\\\/wp-content\\\/uploads\\\/2021\\\/02\\\/lios-okapya-atlassian-entete.jpg\",\"width\":1920,\"height\":1080},{\"@type\":\"BreadcrumbList\",\"@id\":\"http:\\\/\\\/www.lios.ca\\\/en\\\/realisation\\\/documentation-for-a-jira-application\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"http:\\\/\\\/www.lios.ca\\\/en\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"R\u00e9alisations\",\"item\":\"http:\\\/\\\/www.lios.ca\\\/en\\\/realisation\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Documentation for a Jira application\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.lios.ca\\\/#website\",\"url\":\"https:\\\/\\\/www.lios.ca\\\/\",\"name\":\"Lios\",\"description\":\"L'information \u00e0 l'oeuvre\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.lios.ca\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Documentation for a Jira application - Lios","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/","og_locale":"en_US","og_type":"article","og_title":"Documentation for a Jira application - Lios","og_description":"Need With their Checklist for Jira\u00a0app, Okapya has developed one of the most popular tools on Atlassian Marketplace. As they were preparing to release an all-new version of Checklist, they also wanted to continue to better serve their users by taking the accompanying documentation to the next level. They envisioned creating online documentation that would […]","og_url":"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/","og_site_name":"Lios","article_modified_time":"2021-02-17T19:37:42+00:00","og_image":[{"width":1920,"height":1080,"url":"http:\/\/www.lios.ca\/wp-content\/uploads\/2021\/02\/lios-okapya-atlassian-entete.jpg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/","url":"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/","name":"Documentation for a Jira application - Lios","isPartOf":{"@id":"https:\/\/www.lios.ca\/#website"},"primaryImageOfPage":{"@id":"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/#primaryimage"},"image":{"@id":"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/#primaryimage"},"thumbnailUrl":"http:\/\/www.lios.ca\/wp-content\/uploads\/2021\/02\/lios-okapya-atlassian-entete.jpg","datePublished":"2021-02-16T17:33:33+00:00","dateModified":"2021-02-17T19:37:42+00:00","breadcrumb":{"@id":"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/#primaryimage","url":"http:\/\/www.lios.ca\/wp-content\/uploads\/2021\/02\/lios-okapya-atlassian-entete.jpg","contentUrl":"http:\/\/www.lios.ca\/wp-content\/uploads\/2021\/02\/lios-okapya-atlassian-entete.jpg","width":1920,"height":1080},{"@type":"BreadcrumbList","@id":"http:\/\/www.lios.ca\/en\/realisation\/documentation-for-a-jira-application\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"http:\/\/www.lios.ca\/en\/"},{"@type":"ListItem","position":2,"name":"R\u00e9alisations","item":"http:\/\/www.lios.ca\/en\/realisation\/"},{"@type":"ListItem","position":3,"name":"Documentation for a Jira application"}]},{"@type":"WebSite","@id":"https:\/\/www.lios.ca\/#website","url":"https:\/\/www.lios.ca\/","name":"Lios","description":"L'information \u00e0 l'oeuvre","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.lios.ca\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"http:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/realisation\/2877","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/realisation"}],"about":[{"href":"http:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/types\/realisation"}],"author":[{"embeddable":true,"href":"http:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/users\/2"}],"version-history":[{"count":4,"href":"http:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/realisation\/2877\/revisions"}],"predecessor-version":[{"id":2885,"href":"http:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/realisation\/2877\/revisions\/2885"}],"wp:attachment":[{"href":"http:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/media?parent=2877"}],"wp:term":[{"taxonomy":"service","embeddable":true,"href":"http:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/service?post=2877"},{"taxonomy":"expertise","embeddable":true,"href":"http:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/expertise?post=2877"},{"taxonomy":"industrie","embeddable":true,"href":"http:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/industrie?post=2877"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}