How to Read the Migration Report

In this article, you’ll learn more about how to interpret the results of the migration report and we will help clarify how well Scroll Documents supports the features you are currently using.

How to Read the Report

In the table below you’ll find an overview of the entries which will appear in your report. Learn what each entry means, and if you’re required to take any action when given a specific value. This table will help you understand what actions will be required to take before you can switch to Scroll Documents.

For help in understanding the more detailed JSON format of the report, refer to the article: How to Read the Migration Report in JSON Format

Report entry	This entry tells you…	Required actions	Additional recommendations
`Space Name`	The name of the space.	NO ACTION REQUIRED	-
`Space Key`	The space key of the space.	NO ACTION REQUIRED	-
`Pages`	How many pages that exist in this space.	If your space has a lot of pages, take this as a chance to clean up the space by removing outdated or redundant content.	-
`Top Level Pages`	How many top-level pages this space has. In other words, how many pages that are on the highest level in the space.	If the value is greater than one, this means you have more than one top-level page in the space. When this is the case, before converting: Go to Space tools > Reorder pages and place all pages in the page tree under the same top-level page. You won’t be able to convert to Scroll Documents until you fulfill this requirement.	Conceptually, Scroll Documents needs all pages to be stored under a single page, which is why you need to potentially reorder the pages.
`Blog Posts`	How many blog posts have been created in this space.	NO ACTION REQUIRED Note If the value is one or more, remember that blog posts are not copied over to the new Scroll Documents managed space. We currently have an improvement for this which you can find here: VSN-4570	If you have multiple blog posts that need to be migrated, please get in touch with our support team at help@k15t.com, and we'll explore how we can assist you.
`Scroll Space Type`	If the value shows: `Master` this means this space is used to publish content into other spaces. `Master(archive)` this means the space has been archived. `Target` this means a master space was published into this space. This target space can contain duplicate page titles or languages.	If the space is a: `Master` space we recommend that you consider converting this space to Scroll Documents. Again, it’s important to note that the in-Confluence publishing feature is currently not available in Scroll Documents (See: DOCS-10). `Master(archive)` space, we recommend you double check if you want to keep the space and convert it to Scroll Documents. `Target` space, think about whether you really need it. If you decide to keep and convert the master space to Scroll Documents, you might not need the target space anymore. This is important because Scroll Documents doesn’t currently support in-Confluence publishing (See: DOCS-10).) You should consider keeping the target space only if: You’re using it for creating content. You’re showing translated content to others using Viewport. You’re exporting specific languages with the Scroll Exporter apps. You need to maintain it for archive purposes.	We recommend to take the conversions as a chance to clean up old spaces and rather not convert archived spaces.
`Scroll Publishing Methods`	If the value shows: `-` this means this space has never published any content using Scroll Versions. `to same` this means this space has been published within the same space. `to new` this means this space has been published to a new space. `to existing` this means this space has been published to an existing space. `to remote` this means the space has been published to a remote Confluence system.	In-Confluence publishing is not yet available as a feature in Scroll Documents. See: DOCS-10 Note Remote publishing to other Confluence systems is also not available in Scroll Document. This is also not something we are planning to implement. As an alternative solution to in-Confluence and remote publishing we recommend that you publish your document as an online help center with Scroll Viewport.	If in-Confluence publishing is important for your case, we recommend you wait to convert until you see progress has been made on: DOCS-10 Alternatively, look into the option of copying versions of your documentation to other spaces. For more information see: Publish Versions and Variants
`Versions`	How many versions the space has.	Decide which versions are necessary to convert. Note In Scroll Documents, the number of pages in the space will be multiplied by the number of versions and languages you have in the space. In short, if you have a lot of pages, versions, and / or languages, this will affect your space size.	We suggest trying to convert as few versions as possible, and view the conversion as a good opportunity to get rid of redundant versions.
`Branches`	If the version tree has several branches, this value tells you how many branches.	NO ACTION REQUIRED	To keep in mind In Scroll Documents it’s not possible to create branches. Your existing version branches will be converted into a linear version tree within Scroll Documents.
`Multiple Root Versions`	If the version tree has several root versions, this value tells you how many root versions the version tree has.	Multiple root versions is a legacy feature in an older version of Scroll Versions. If you find you have multiple root versions, reach out to: help@k15t.com	-
`Variants`	If the space has variants, this value tells you how many variants the space has defined.	Variant management in Scroll Documents works with page labels. Those labels can be defined during conversion and are are automatically assigned. To learn more, read: Manage Variants and Conditional Content	-
`Attributes`	If the space has variants, this value tells you how many attributes the space has defined.		-
`Attribute Values`	If the space has variants, this value tells you how many attribute values the space has defined.		-
`Languages`	How many languages are in the space.	Decide which languages are necessary to convert. Note In Scroll Documents, the number of pages in the space will be multiplied by the number of versions and languages you have in the space. In short, if you have a lot of pages, versions, and / or languages this will affect space size.	We suggest trying to convert as few languages as possible, and view the conversion as a good opportunity to get rid of redundant content.
`Workflow`	If the value shows: `Simple` this means you are using the Scroll Versions inbuilt workflow in this space. `Comala` this means the space uses Scroll Versions and Comala Document Management to manage workflows.	Scroll Documents does not have any inbuilt workflow and does not integrate with Comala Document Management. Instead, you would need to work with Scroll Documents' own restrictions and reports to maintain an author and review process. We recommend learning more about this before converting. See: Compare, Track, and Review Versions and Variants	We will be looking into potentially supporting workflows in a future version of Scroll Documents, as well as a potential integration with Comala. To follow the progress, see: Support for workflows/approvals: DOCS-17 Integration with Comala Workflows: DOCS-36
`Include Library`	The Include Library feature is in use in this space.	Continue to the report entries `Included by` and `Includes` to confirm if content from this space is included in another space, alternatively if it includes content from other spaces.	-
`Included by`	If the value shows `Yes` , this means this space is an Include Library. The content from this space is included in other spaces / documentation spaces.	The Include Library feature is currently not fully supported in Scroll Documents. As it works currently, the included content will instead be converted into the new Scroll Documents managed space: Conversion with Include Libraries The source pages of the included content will be copied and added to the top-level above the home page.	If the outcome described does not fulfil your requirements, we recommend you wait to convert and reach out to our support via: help@k15t.com
`Including`	If the value shows `Yes` , this means this is a documentation space which reuses content from other spaces via an Include Library
`Incoming Links`	This value assesses the amount of incoming links from other spaces that point to pages in this space.	The conversion tool can only process one space at a time and generates new Confluence pages. As a result, links from other spaces will continue to direct to the pre-conversion pages managed by Scroll Versions and Translations.	It is necessary to manually update the links in order to direct them to the correct new pages within the converted space. We have recently introduced a solution that enables you to update links pointing to the pre-conversion pages managed by Scroll Versions and Translations, directing them to the corresponding pages within the converted space. For more information, please read: Migrate Links Pointing to Converted Spaces

To learn how to generate the report, refer to: The Migration Report