Please clarify "viewer" -vs- "work area"...

[pnelson2]

We just had a long, complicated discussion in the OpenToonz community about what exactly is the distinction between Viewer and Work Area in OpenToonz 1.2. The documentation has two different sections for these two things, but by the end of the discussion we decided they are really the same.

I think this should be clearer in the documentation.

For details of the confusion see: https://groups.google.com/forum/#!category-topic/opentoonz_en/general-discussion/rAbjZcRfXsY

Thanks in advance.

[shun-iwasawa]

Thank you @pnelson2 for the post and detailed discussions done so far in the forum!
Since we are still very small team, we really appreciate if you could modify & post a PR for this matter.
And if you are interested, we will also be willing to assign you a collaborator access which will enable you to merge modifications by yourself. Please post a request to the issue #4 .

[pnelson2]

Hi shun-iwasawa I'm not familiar with your development protocol so I don't know what "modify and post a PR" means. And I'm a complete OpenToonz Noob so I should not be trusted to make any changes in the documentation yet. BTW, what is the official latest rev of the User Manual in English? The latest I can find is 1.13 on https://opentoonz.readthedocs.io/en/latest/ but there are discrepancies in the description of the Function Editor and what I see on 1.21. Why is the User Manual on a separate site from the code? Is it managed by a different group in the project? I'll be happy to help when I get more up-to-speed with OpenToonz but if I touch anything at this stage I'll break it. Peter Nelson

…

---------------------------------------- From: "shun-iwasawa" <[email protected]> Sent: Thursday, July 12, 2018 12:47 AM To: "opentoonz/opentoonz_docs" <[email protected]> Cc: "pnelson2" <[email protected]>, "Mention" <[email protected]> Subject: Re: [opentoonz/opentoonz_docs] Please clarify "viewer" -vs- "work area"... (#9) Thank you @pnelson2 for the post and detailed discussions done so far in the forum! Since we are still very small team, we really appreciate if you could modify & post a PR for this matter. And if you are interested, we will also be willing to assign you a collaborator access which will enable you to merge modifications by yourself. Please post a request to the issue #4 . - You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread. <script type="application/json" data-scope="inboxmarkup">{"api_version":"1.0","publisher":{"api_key":"05dde50f1d1a384dd78767c55493e4bb","name":"GitHub"},"entity":{"external_key":"github/opentoonz/opentoonz_docs","title":"opentoonz/opentoonz_docs","subtitle":"GitHub repository","main_image_url":"https://assets-cdn.github.com/images/email/message_cards/header.png","avatar_image_url":"https://assets-cdn.github.com/images/email/message_cards/avatar.png","action":{"name":"Open in GitHub","url":"https://github.com/opentoonz/opentoonz_docs"}},"updates":{"snippets":[{"icon":"PERSON","message":"@shun-iwasawa in #9: Thank you @pnelson2 for the post and detailed discussions done so far in the forum! \r\nSince we are still very small team, we really appreciate if you could modify \u0026 post a PR for this matter.\r\nAnd if you are interested, we will also be willing to assign you a collaborator access which will enable you to merge modifications by yourself. Please post a request to the issue #4 ."}],"action":{"name":"View Issue","url":"#9 (comment)"}}}</script> <script type="application/ld+json">[ { "@context": "http://schema.org", "@type": "EmailMessage", "potentialAction": { "@type": "ViewAction", "target": "#9 (comment)", "url": "#9 (comment)", "name": "View Issue" }, "description": "View this Issue on GitHub", "publisher": { "@type": "Organization", "name": "GitHub", "url": "https://github.com" } }, { "@type": "MessageCard", "@context": "http://schema.org/extensions", "hideOriginalBody": "false", "originator": "AF6C5A86-E920-430C-9C59-A73278B5EFEB", "title": "Re: [opentoonz/opentoonz_docs] Please clarify \"viewer\" -vs- \"work area\"... (#9)", "sections": [ { "text": "", "activityTitle": "**shun-iwasawa**", "activityImage": "https://assets-cdn.github.com/images/email/message_cards/avatar.png", "activitySubtitle": "@shun-iwasawa", "facts": [ ] } ], "potentialAction": [ { "name": "Add a comment", "@type": "ActionCard", "inputs": [ { "isMultiLine": true, "@type": "TextInput", "id": "IssueComment", "isRequired": false } ], "actions": [ { "name": "Comment", "@type": "HttpPOST", "target": "https://api.github.com", "body": "{\n\"commandName\": \"IssueComment\",\n\"repositoryFullName\": \"opentoonz/opentoonz_docs\",\n\"issueId\": 9,\n\"IssueComment\": \"{{IssueComment.value}}\"\n}" } ] }, { "name": "Close issue", "@type": "HttpPOST", "target": "https://api.github.com", "body": "{\n\"commandName\": \"IssueClose\",\n\"repositoryFullName\": \"opentoonz/opentoonz_docs\",\n\"issueId\": 9\n}" }, { "targets": [ { "os": "default", "uri": "#9 (comment)" } ], "@type": "OpenUri", "name": "View on GitHub" }, { "name": "Unsubscribe", "@type": "HttpPOST", "target": "https://api.github.com", "body": "{\n\"commandName\": \"MuteNotification\",\n\"threadId\": 355511013\n}" } ], "themeColor": "26292E" } ]</script>

[shun-iwasawa]

I'm not familiar with your development protocol so I don't know what "modify and post a PR" means. And I'm a complete OpenToonz Noob so I should not be trusted to make any changes in the documentation yet.

"PR" stands for "Pull Request", one of the main features of GitHub.
If you happen to be interested, there is a brief description of contribution process in CONTRIBUTING.md .

BTW, what is the official latest rev of the User Manual in English?

https://opentoonz.readthedocs.io/en/latest/ is the latest revision of the user manual.
The user manual is based on Toonz Harlequin 7.1. And unfortunately, it is not yet revised from the original due to a manpower shortage. Although many parts in the software overlap, some parts (like panel layout of Function Editor, as you pointed) had been modified and the manual has not been updated.

Why is the User Manual on a separate site from the code? Is it managed by a different group in the project?

In order to make update process of the user manual smoother, we decided to assign the collaborator access to wider circle of community members.
GitHub has no customizability in the collaborator access. We cannot restrict some collaborator to change the code while allowing him to modify the user manual, as long as both of them are in the same repository. So, separating them into two repositories was reasonable for us to manage the role of contributors.