...
Notes for the documentation template: Each section contains a description about its purpose, if it is mandatory or optional and an example that begins or contains the words "Lorem ipsum".
Description
Mandatory elementsection. The description should follow the title directly without a heading. Use this section to provide a general, high-level overview about the step or job entry. For example:
...
This section may include the following subsections:
Context
Prerequisites
Installation
Configuration
Prerequisites
(Optional, in case prerequisites needs Mandatory section. Use this section to describe the context surrounding when this step or job entry is used. It is also possible to link to another page which has workflows and tasks.
The context might include . . .
Prerequisites
Optional section. Use when prerequisites need to be met and/or checked.) Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
Installation
(Optional, in case installation topics Optional section. Use when installation tasks need to be performed.) Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
Configuration
(Optional, in case configuration topics Optional section. Use when configuration tasks need to be performed.) Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
Options
(Mandatory, describe Mandatory section. This section describes the Options and Description for each property of the step or job entry using a table. When multiple tabs are included , separate the Options within these tabs (see Lorem ipsum tab 1 & 2). in a dialog box, use subsections titled by tab such as "Sample 1 Tab" and "Sample 2 Tab". Optionally, you can preface the table with information, if needed.
TBD: 1) Omit not needed information: e.g. step name (should be describes not within each step/job entry but at the beginning) 2) Should we omit other obvious properties? 3) Should we omit the recurring information in field tables like: field name, type, length, precision etc. ?)
Use a screenshot before the table for each tab.
Option | Description |
---|---|
Lorem ipsum option1 Option1 | Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam. Lorem ipsum option2 |
Option2 | Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam
|
...
Sample 1 Tab
Use a screenshot of each tab before the table.
Option | Description |
---|---|
Lorem ipsum option1 | Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam. |
Lorem ipsum option2 | Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam |
...
Sample 2 Tab
Use a screenshot of each tab before the table.
Option | Description |
---|---|
Lorem ipsum option1 | Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam. |
Lorem ipsum option2 | Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam |
...
Example
(Mandatory, describe the context when this step or job entry is used. It is also possible to link to another page.)
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
Example
(Mandatory, describe at least one example or link to Mandatory section. Describe at least one example, link to another page, or reference at least one a sample within the PDI distribution.)
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
Sample
Samples within the PDI distribution can be found here: data-integration/samples/transformations/Aggregate - basics.ktr Lorem ipsum
When referring out to another page, place the link in a sentence: "A list of example lorem ipsum text can be found here: http://en.wikipedia.org/wiki/Lorem_ipsum"
Sample(s)
Optional section. This section is similar to the Example section except that it exclusively refers to the samples with the PDI distribution. Samples within the PDI distribution can be found here: data-integration/samples/transformations/Aggregate - basics.ktr. Even if you use an example in the above section, if other samples exist for the step or entry, you should refer users to those samples.
Reference Information
(Optional, in case Optional section. Use this section to list internal or external links are related to this documentation topic, list them in this section.)step/entry topic.
Lorem ipsum: http://en.wikipedia.org/wiki/Lorem_ipsum
Technical Information
(Optional, in case Optional section. Use this section when to provide technical documentation for developers is provided, like to developers. For example, you can include a link to the source code, special topics for developers, or links to the source code or Javadoc.)Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
Lorem ipsum: http://en.wikipedia.org/wiki/Lorem_ipsum