Documentation doesn't match with UI #100041

New Issue

Hoang Duy Tran · 2022-07-28T12:15:43+02:00

Hoang Duy Tran commented

2022-07-28 12:15:43 +02:00

System Information
Operating system: macOS-10.15.7-x86_64-i386-64bit 64 Bits

Blender Version
Broken: version: 3.3.0 Alpha, branch: master, commit date: 2022-07-14 22:44, hash: blender/blender@0e9367fc29

Short description of error
In this section of the user manual:

Regions => Vertical/Horizontal Split
There is a piece of text describing the area splitting function:

Vertical/Horizontal Split
Shows an indicator line that lets you select the area and position where to split. Tab switches between vertical/horizontal.

This is no longer matching with the actual UI display. What you see on the UI is a plus sign icon (+) appear and you will have to drag that plus cursor inside - for vertical split, or down/up for horizontal split.

Please update the documentation to match the UI behaviour

Exact steps for others to reproduce the error

Open Blender
Put mouse pointer at the corner of the area until you see a plus icon (split cursor) appears.
Press and hold left mouse button and drag towards inside of the area for vertical splitting, or up/down for horizontal splitting

**System Information** Operating system: macOS-10.15.7-x86_64-i386-64bit 64 Bits **Blender Version** Broken: version: 3.3.0 Alpha, branch: master, commit date: 2022-07-14 22:44, hash: `blender/blender@0e9367fc29` **Short description of error** In this section of the user manual: [Regions => Vertical/Horizontal Split](https://docs.blender.org/manual/en/dev/interface/window_system/regions.html) There is a piece of text describing the area splitting function: ``` Vertical/Horizontal Split Shows an indicator line that lets you select the area and position where to split. Tab switches between vertical/horizontal. ``` This is no longer matching with the actual UI display. What you see on the UI is a plus sign icon (+) appear and you will have to drag that plus cursor inside - for vertical split, or down/up for horizontal split. Please update the documentation to match the UI behaviour **Exact steps for others to reproduce the error** - Open Blender - Put mouse pointer at the corner of the area until you see a plus icon (split cursor) appears. - Press and hold left mouse button and drag towards inside of the area for vertical splitting, or up/down for horizontal splitting

Hoang Duy Tran commented

2022-07-28 12:15:43 +02:00

Added subscriber: @hoanguk

Pablo Vazquez commented

2022-07-28 12:21:25 +02:00

Added subscriber: @pablovazquez

Pablo Vazquez commented

2022-07-28 12:21:25 +02:00

Nice catch! Screenshots on this page and many others need to be updated.

Maintaining documentation is a community effort. Would you be up for updating these images? Something similar to what's already there but with the latest UI in 3.3 Beta would be enough I think. Perhaps using a higher resolution scale in the preferences.

You can also drop by #docs to discuss.

Thanks!

Nice catch! Screenshots on this page and many others need to be updated. Maintaining documentation is a community effort. Would you be up for updating these images? Something similar to what's already there but with the latest UI in 3.3 Beta would be enough I think. Perhaps using a higher resolution scale in the preferences. You can also drop by [#docs](https://blender.chat/channel/docs) to discuss. Thanks!

Hoang Duy Tran commented

2022-07-28 12:31:15 +02:00

I would not mind doing it if I have time. At the moment, I'm translating a huge amount of text to Vietnamese. I choose to ignore ones that no longer matches the UI but other than that I'm translating texts that do, and also reading up on changes as well. In short, I cannot as I have no time left. Thank you for asking.

Pratik Borhade commented

2022-07-28 14:07:11 +02:00

Added subscriber: @PratikPB2123

Pratik Borhade commented

2022-07-28 14:07:52 +02:00

Changed status from 'Needs Triage' to: 'Confirmed'

Hoang Duy Tran commented

2022-07-28 15:00:40 +02:00

Info on this page

Status Bar

no longer applied. One has to RIGHT click on the bar to review a popup menu and choose which items to display. Please update.

Info on this page [Status Bar](https://docs.blender.org/manual/en/dev/interface/window_system/status_bar.html) no longer applied. One has to RIGHT click on the bar to review a popup menu and choose which items to display. Please update.

Hoang Duy Tran commented

2022-07-28 15:18:18 +02:00

I need to know which section of the current 3.3 manual still working as designed and documented, so I can continue the translation. Can someone in charge with the Documentation informing us translators please?

Aaron Carlisle commented

2022-07-30 04:57:34 +02:00

Added subscriber: @Blendify

Aaron Carlisle commented

2022-07-30 04:57:34 +02:00

In #100041#1396587, @hoanguk wrote:
I need to know which section of the current 3.3 manual still working as designed and documented, so I can continue the translation. Can someone in charge with the Documentation informing us translators please?

This is a hard question to answer because the manual is not updated chapter by chapter.

You can see a list of changes still pending here: #98243

> In #100041#1396587, @hoanguk wrote: > I need to know which section of the current 3.3 manual still working as designed and documented, so I can continue the translation. Can someone in charge with the Documentation informing us translators please? This is a hard question to answer because the manual is not updated chapter by chapter. You can see a list of changes still pending here: #98243

Matthew Hinson commented

2022-07-30 12:38:33 +02:00

Added subscriber: @Matthew-Hinson

Matthew Hinson commented

2022-07-30 12:38:33 +02:00

I think the part about area splitting is in fact still correct. It's just a bit confusing because there two ways of doing it:

The one you quoted from the "Regions" page of the manual, which is triggered from the area header's context menu. This still applies to 3.3.
The one you described yourself, where you start dragging with LMB from the corner of an area. This method is described on the "Areas" page: https://docs.blender.org/manual/en/dev/interface/window_system/areas.html#splitting

For the status bar, the documentation already says to use RMB to choose the information to display, so I'm not sure what's wrong there.

I think the part about area splitting is in fact still correct. It's just a bit confusing because there two ways of doing it: - The one you quoted from the "Regions" page of the manual, which is triggered from the area header's context menu. This still applies to 3.3. - The one you described yourself, where you start dragging with LMB from the corner of an area. This method is described on the "Areas" page: https://docs.blender.org/manual/en/dev/interface/window_system/areas.html#splitting For the status bar, the documentation already says to use RMB to choose the information to display, so I'm not sure what's wrong there.

Hoang Duy Tran commented

2022-07-30 20:37:15 +02:00

I think the part that created confusion for me is :

Shows an indicator line

I was looking for an indicator line which doesn't appear. Instead, I see the cross icon (+) . Next is the text should mention the fact that one need to drag the mouse "inside" for vertical split, and "up/down" for horizontal split.

I think the part that created confusion for me is : ``` Shows an indicator line ``` I was looking for an indicator line which doesn't appear. Instead, I see the cross icon (+) . Next is the text should mention the fact that one need to drag the mouse "inside" for vertical split, and "up/down" for horizontal split.

Matthew Hinson commented

2022-07-30 22:20:18 +02:00

The indicator line appears when you use the context menu. That's also what that part of the documentation is about.

The (+) cursor is documented separately on the "Areas" page.

The indicator line appears when you use the context menu. That's also what that part of the documentation is about. The (+) cursor is documented separately on the "Areas" page.

Hoang Duy Tran commented

2022-07-31 03:27:26 +02:00

Matthew, you're so correct. I tried the context menu again and it worked exactly the way it is described. I did not see this before. Thank you for commenting and guidance.

Bast Regards,

Matthew, you're so correct. I tried the context menu again and it worked exactly the way it is described. I did not see this before. Thank you for commenting and guidance. Bast Regards,

Aaron Carlisle commented

2022-08-31 22:49:03 +02:00

Changed status from 'Confirmed' to: 'Resolved'

Aaron Carlisle closed this issue

2022-08-31 22:49:03 +02:00

Aaron Carlisle self-assigned this 2022-08-31 22:49:03 +02:00

Aaron Carlisle commented

2022-08-31 22:49:03 +02:00

Closing this task as resolved as it appears to have been a misunderstanding.

Sign in to join this conversation.

No Label

Download

What's New

Blender Studio

Manual

Developers Blog

Documentation

Benchmark

Blender Conference

Development Fund

One-time Donations

Documentation doesn't match with UI #100041