Issue 61081 - Cover the entire lifecycle for each object and its property
Summary: Cover the entire lifecycle for each object and its property
Status: ACCEPTED
Alias: None
Product: documentation
Classification: Unclassified
Component: Online help (show other issues)
Version: OOo 2.0
Hardware: All All
: P3 Trivial (vote)
Target Milestone: AOO PleaseHelp
Assignee: AOO issues mailing list
QA Contact:
URL:
Keywords:
Depends on:
Blocks: 29679
  Show dependency tree
 
Reported: 2006-01-24 05:29 UTC by raindrops
Modified: 2017-05-20 11:31 UTC (History)
1 user (show)

See Also:
Issue Type: DEFECT
Latest Confirmation in: ---
Developer Difficulty: ---


Attachments

Note You need to log in before you can comment on or make changes to this issue.
Description raindrops 2006-01-24 05:29:07 UTC
Each object entered in the document would have to follow different phases of
lifecycle:
(a) Inserting/creating/setting
(b) modifying/editing/updating
(c) removing/deleting/clearing/resetting

In fact, the liffecycle concept applies to the properties of a given object also.

In other words, the lifecycle concept applies to-
>> Objects such as images, text, frames, tables, etc... 
>> Their properties such as format, style, etc..

Therefore, any help topic discussing the item MUST describe ALL the phases, 
or have a cross-reference to other topics that contain this description. 

In other words, regardless of WHERE the user starts reading, the help file/User
guide should be able to describe the entire lifecycle seamlessly.

But the OOo documentation leaves many topics incomplete in this regard.
Some examples (help file):
(a) the "inserting cross-references" topic page of the help file does not have a
link to "deleting cross-references".
(b) try searching for "removing hyperlink"

Desired: Review each topic from this criteria-- "Have we addressed the three
essential stages of its lifecycle?"

Suggested alternative ways to implement this:
1. Do not bury this in the description: provide a linkage to bottom.
2. Have a "standard" structure for each help page. For example-
>> Title
>> What it is (definition), 
>> why/where needed (i.e. scenarios for using it), 
>> Description of lifecycle phases, and how to DO it. (how to use the
menus/toolbar buttons, etc)
>> "See also-" section (to describe similar/opposite effect achieved by other
commands)
Comment 1 Uwe Fischer 2006-01-27 10:52:53 UTC
should be done for sure. Must set to "later" for now.
Comment 2 grsingleton 2006-01-27 13:34:24 UTC
As this is also an issue with 29679 I have made this issue a dependency of
29679. Just in case the Help editors do add this info first.
Comment 3 grsingleton 2006-01-27 13:48:17 UTC
As this is also an issue with 29679 I have made this issue a dependency of
29679. Just in case the Help editors do add this info first.
Comment 4 Marcus 2017-05-20 11:31:06 UTC
Reset assigne to the default "issues@openoffice.apache.org".