Re: [oXygen-user] Tags view in oXygen Author mode

I prefer the "partial tags" mode as it makes for the least clutter but still makes it clear where tag boundaries are in running text. I'm also used to using the breadcrumbs to know what my element context is or using the outline view to navigate around in the absence of tags in the main view. But I know a lot of people prefer the full-tags mode and that's probably the best starting point for new authors. Full tags with attributes tends to be too much noise and you can always use the attributes panel to see what the attributes are. Cheers, Eliot ---- Eliot Kimber, Owner Contrext, LLC http://contrext.com From: <oxygen-user-bounces@oxygenxml.com> on behalf of "Sanford, Richard C" <richard.c.sanford@boeing.com> Date: Friday, May 20, 2016 at 2:49 PM To: Oxygen User <oxygen-user@oxygenxml.com> Subject: [oXygen-user] Tags view in oXygen Author mode I¹m creating authoring guidelines for a group of training developers who will use oXygen XML Author to edit DITA content in Author mode. I would like to be able to recommend a tags view. The screen captures, and sometimes the procedures in my documentation, are dependent on the tags view. Since I use Text mode 99% of the time, I would appreciate advice on the most usable, or the most commonly used, tags view. One of the training developers is experienced in Structured FrameMaker; the others have little or no experience with a structured authoring tool. Thanks. Richard _______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user

Great, thanks! From: Eliot Kimber [mailto:ekimber@contrext.com] Sent: Friday, May 20, 2016 2:55 PM To: Sanford, Richard C <richard.c.sanford@boeing.com>; oxygen-user@oxygenxml.com Subject: Re: [oXygen-user] Tags view in oXygen Author mode I prefer the "partial tags" mode as it makes for the least clutter but still makes it clear where tag boundaries are in running text. I'm also used to using the breadcrumbs to know what my element context is or using the outline view to navigate around in the absence of tags in the main view. But I know a lot of people prefer the full-tags mode and that's probably the best starting point for new authors. Full tags with attributes tends to be too much noise and you can always use the attributes panel to see what the attributes are. Cheers, Eliot ---- Eliot Kimber, Owner Contrext, LLC http://contrext.com From: <oxygen-user-bounces@oxygenxml.com<mailto:oxygen-user-bounces@oxygenxml.com>> on behalf of "Sanford, Richard C" <richard.c.sanford@boeing.com<mailto:richard.c.sanford@boeing.com>> Date: Friday, May 20, 2016 at 2:49 PM To: Oxygen User <oxygen-user@oxygenxml.com<mailto:oxygen-user@oxygenxml.com>> Subject: [oXygen-user] Tags view in oXygen Author mode I'm creating authoring guidelines for a group of training developers who will use oXygen XML Author to edit DITA content in Author mode. I would like to be able to recommend a tags view. The screen captures, and sometimes the procedures in my documentation, are dependent on the tags view. Since I use Text mode 99% of the time, I would appreciate advice on the most usable, or the most commonly used, tags view. One of the training developers is experienced in Structured FrameMaker; the others have little or no experience with a structured authoring tool. Thanks. Richard _______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com<mailto:oXygen-user@oxygenxml.com> https://www.oxygenxml.com/mailman/listinfo/oxygen-user

If you're writing an authoring guide probably useful to discuss those three tag modes, the context breadcrumbs, the outline view, and the attributes view so authors know they have options. Cheers, E. ---- Eliot Kimber, Owner Contrext, LLC http://contrext.com From: "Sanford, Richard C" <richard.c.sanford@boeing.com> Date: Friday, May 20, 2016 at 4:57 PM To: Eliot Kimber <ekimber@contrext.com>, Oxygen User <oxygen-user@oxygenxml.com> Subject: RE: [oXygen-user] Tags view in oXygen Author mode Great, thanks! From: Eliot Kimber [mailto:ekimber@contrext.com] Sent: Friday, May 20, 2016 2:55 PM To: Sanford, Richard C <richard.c.sanford@boeing.com>; oxygen-user@oxygenxml.com Subject: Re: [oXygen-user] Tags view in oXygen Author mode I prefer the "partial tags" mode as it makes for the least clutter but still makes it clear where tag boundaries are in running text. I'm also used to using the breadcrumbs to know what my element context is or using the outline view to navigate around in the absence of tags in the main view. But I know a lot of people prefer the full-tags mode and that's probably the best starting point for new authors. Full tags with attributes tends to be too much noise and you can always use the attributes panel to see what the attributes are. Cheers, Eliot ---- Eliot Kimber, Owner Contrext, LLC http://contrext.com From: <oxygen-user-bounces@oxygenxml.com> on behalf of "Sanford, Richard C" <richard.c.sanford@boeing.com> Date: Friday, May 20, 2016 at 2:49 PM To: Oxygen User <oxygen-user@oxygenxml.com> Subject: [oXygen-user] Tags view in oXygen Author mode I¹m creating authoring guidelines for a group of training developers who will use oXygen XML Author to edit DITA content in Author mode. I would like to be able to recommend a tags view. The screen captures, and sometimes the procedures in my documentation, are dependent on the tags view. Since I use Text mode 99% of the time, I would appreciate advice on the most usable, or the most commonly used, tags view. One of the training developers is experienced in Structured FrameMaker; the others have little or no experience with a structured authoring tool. Thanks. Richard _______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user

Hi, I totally agree with Eliot. The operator should know how to switch between the tag views, and also how to use the breadcrumbs and what they mean. Additionally, I would add the trick of keeping half an eye on the outline view if there are ever questions about where your cursor is pointing in Author mode. In fact, clicking around the Outline and watching the breadcrumbs and element selection is a good lesson in what's going on (to people used only to dynamic WYSIWYG UIs -- or to the already-knowledgeable such as a Structured Framemaker person). In Author mode I end up using Partial Tags or No Tags most of the time, rarely (but not never) switching to one of the other tag views in Author. It is interesting how, given other cues (such as the breadcrumbs, also what the CSS may offer), the brain learns to "see" the element containment hierarchy. And this happens despite the fact that (in my case) Every Week is a New Document Type, so the particular elements in the hierarchy are not even the same as last time. One reason I will switch to Full Tags or Block Tags is so I can drag and drop using tag icons as handles. This is a nice thing to demo as well. The point, however, should be that the different views are useful in their different ways, and operators should do what works for them -- while knowing all their options. Cheers, Wendell On Fri, May 20, 2016 at 6:03 PM, Eliot Kimber <ekimber@contrext.com> wrote:
If you're writing an authoring guide probably useful to discuss those three tag modes, the context breadcrumbs, the outline view, and the attributes view so authors know they have options.
Cheers,
E. ---- Eliot Kimber, Owner Contrext, LLC http://contrext.com
From: "Sanford, Richard C" <richard.c.sanford@boeing.com> Date: Friday, May 20, 2016 at 4:57 PM To: Eliot Kimber <ekimber@contrext.com>, Oxygen User <oxygen-user@oxygenxml.com> Subject: RE: [oXygen-user] Tags view in oXygen Author mode
Great, thanks!
From: Eliot Kimber [mailto:ekimber@contrext.com] Sent: Friday, May 20, 2016 2:55 PM To: Sanford, Richard C <richard.c.sanford@boeing.com>; oxygen-user@oxygenxml.com Subject: Re: [oXygen-user] Tags view in oXygen Author mode
I prefer the "partial tags" mode as it makes for the least clutter but still makes it clear where tag boundaries are in running text. I'm also used to using the breadcrumbs to know what my element context is or using the outline view to navigate around in the absence of tags in the main view.
But I know a lot of people prefer the full-tags mode and that's probably the best starting point for new authors.
Full tags with attributes tends to be too much noise and you can always use the attributes panel to see what the attributes are.
Cheers,
Eliot
----
Eliot Kimber, Owner
Contrext, LLC
From: <oxygen-user-bounces@oxygenxml.com> on behalf of "Sanford, Richard C" <richard.c.sanford@boeing.com> Date: Friday, May 20, 2016 at 2:49 PM To: Oxygen User <oxygen-user@oxygenxml.com> Subject: [oXygen-user] Tags view in oXygen Author mode
I’m creating authoring guidelines for a group of training developers who will use oXygen XML Author to edit DITA content in Author mode. I would like to be able to recommend a tags view. The screen captures, and sometimes the procedures in my documentation, are dependent on the tags view. Since I use Text mode 99% of the time, I would appreciate advice on the most usable, or the most commonly used, tags view.
One of the training developers is experienced in Structured FrameMaker; the others have little or no experience with a structured authoring tool.
Thanks.
Richard
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
-- Wendell Piez | http://www.wendellpiez.com XML | XSLT | electronic publishing Eat Your Vegetables _____oo_________o_o___ooooo____ooooooo_^

I use the outline view exclusively for dragging and dropping, so I almost never use the full-tags view. Cheers, E. ---- Eliot Kimber, Owner Contrext, LLC http://contrext.com On 5/27/16, 8:48 AM, "Wendell Piez" <oxygen-user-bounces@oxygenxml.com on behalf of wapiez@wendellpiez.com> wrote:
Hi,
I totally agree with Eliot. The operator should know how to switch between the tag views, and also how to use the breadcrumbs and what they mean. Additionally, I would add the trick of keeping half an eye on the outline view if there are ever questions about where your cursor is pointing in Author mode. In fact, clicking around the Outline and watching the breadcrumbs and element selection is a good lesson in what's going on (to people used only to dynamic WYSIWYG UIs -- or to the already-knowledgeable such as a Structured Framemaker person).
In Author mode I end up using Partial Tags or No Tags most of the time, rarely (but not never) switching to one of the other tag views in Author. It is interesting how, given other cues (such as the breadcrumbs, also what the CSS may offer), the brain learns to "see" the element containment hierarchy. And this happens despite the fact that (in my case) Every Week is a New Document Type, so the particular elements in the hierarchy are not even the same as last time.
One reason I will switch to Full Tags or Block Tags is so I can drag and drop using tag icons as handles. This is a nice thing to demo as well. The point, however, should be that the different views are useful in their different ways, and operators should do what works for them -- while knowing all their options.
Cheers, Wendell
On Fri, May 20, 2016 at 6:03 PM, Eliot Kimber <ekimber@contrext.com> wrote:
If you're writing an authoring guide probably useful to discuss those three tag modes, the context breadcrumbs, the outline view, and the attributes view so authors know they have options.
Cheers,
E. ---- Eliot Kimber, Owner Contrext, LLC http://contrext.com
From: "Sanford, Richard C" <richard.c.sanford@boeing.com> Date: Friday, May 20, 2016 at 4:57 PM To: Eliot Kimber <ekimber@contrext.com>, Oxygen User <oxygen-user@oxygenxml.com> Subject: RE: [oXygen-user] Tags view in oXygen Author mode
Great, thanks!
From: Eliot Kimber [mailto:ekimber@contrext.com] Sent: Friday, May 20, 2016 2:55 PM To: Sanford, Richard C <richard.c.sanford@boeing.com>; oxygen-user@oxygenxml.com Subject: Re: [oXygen-user] Tags view in oXygen Author mode
I prefer the "partial tags" mode as it makes for the least clutter but still makes it clear where tag boundaries are in running text. I'm also used to using the breadcrumbs to know what my element context is or using the outline view to navigate around in the absence of tags in the main view.
But I know a lot of people prefer the full-tags mode and that's probably the best starting point for new authors.
Full tags with attributes tends to be too much noise and you can always use the attributes panel to see what the attributes are.
Cheers,
Eliot
----
Eliot Kimber, Owner
Contrext, LLC
From: <oxygen-user-bounces@oxygenxml.com> on behalf of "Sanford, Richard C" <richard.c.sanford@boeing.com> Date: Friday, May 20, 2016 at 2:49 PM To: Oxygen User <oxygen-user@oxygenxml.com> Subject: [oXygen-user] Tags view in oXygen Author mode
I¹m creating authoring guidelines for a group of training developers who will use oXygen XML Author to edit DITA content in Author mode. I would like to be able to recommend a tags view. The screen captures, and sometimes the procedures in my documentation, are dependent on the tags view. Since I use Text mode 99% of the time, I would appreciate advice on the most usable, or the most commonly used, tags view.
One of the training developers is experienced in Structured FrameMaker; the others have little or no experience with a structured authoring tool.
Thanks.
Richard
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
-- Wendell Piez | http://www.wendellpiez.com XML | XSLT | electronic publishing Eat Your Vegetables _____oo_________o_o___ooooo____ooooooo_^ _______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
participants (3)
-
Eliot Kimber
-
Sanford, Richard C
-
Wendell Piez