Difference between revisions of "Documentation/Dashboard/Help Style Guide"
From Apache OpenOffice Wiki
< Documentation | Dashboard
(→Distribution of Function Descriptions) |
(→Distribution of Function Descriptions in the Help) |
||
Line 62: | Line 62: | ||
===Distribution of Function Descriptions in the Help=== | ===Distribution of Function Descriptions in the Help=== | ||
− | * '''One section/file for | + | * '''One section/file for Calc function:''' Every Calc function should be presented as a self-contained entity as we have it already for some functions like DATE, HOUR, YEAR and some others. |
− | * '''One function list for every function category:''' The individual | + | * '''One function list for every function category:''' The individual Calc functions should be bundled in a category section/file. These category files should contain a list of the related functions, each with a short description that can be taken from the function file |
===Completeness of Functions Descriptions=== | ===Completeness of Functions Descriptions=== |
Revision as of 10:21, 4 December 2007
Contents
Help "Guides" (How-to instructions)
Calc functions
A typical help text for a Calc function should follow this scheme of paragraph styles:
Style | Function | Example |
---|---|---|
hidden text | Index entry | <BOOKMARKVALUE>DATE function</BOOKMARKVALUE> |
|
Second level heading | DATE
|
hlp_paragraph | Function description | This function converts a date written as year, month, day to an internal serial number and displays it in the cell's formatting. The default format of a cell containing the DATE function is the date format, but you can format the cells with the 0 number format, which displays the internal serial number of the date as a number. |
|
Third level heading | Syntax
|
|
Syntax definition | DATE(Year; Month; Day) |
|
Explanation of function arguments | Year is an integer between 1583 and 9956 or 0 and 99. In Tools - Options - StarOffice - General you can set from which year a two-digit number entry is recognized as 20xx. |
|
Third level heading | Example
|
|
Example | =DATE(00;1;31) yields 1/31/00 if the cell format setting is "MM/DD/YY". |
Distribution of Function Descriptions in the Help
- One section/file for Calc function: Every Calc function should be presented as a self-contained entity as we have it already for some functions like DATE, HOUR, YEAR and some others.
- One function list for every function category: The individual Calc functions should be bundled in a category section/file. These category files should contain a list of the related functions, each with a short description that can be taken from the function file