The description of rules of structured descriptions
Topics
About: notation
The table of contents of this article
- Starting Context
- Target Context
- Orientation
- Main Body
- 1: Motive for Structured Descriptions
- 2: The Rules of Structured Descriptions of Propositions
- 3: The Rules of Structured Descriptions of Definitions
- 4: It is Work in Progress
Starting Context
- Nothing
Target Context
- The reader will have the description of the rules of structured descriptions.
Orientation
There is a list of definitions discussed so far in this site.
There is a list of propositions discussed so far in this site.
Main Body
1: Motive for Structured Descriptions
When we read Description (or Natural Language Description) of a proposition in this series, we often feel the format not optimal for comprehending the contents as promptly as possible, and we began to think that there should be a format that is more efficient for reading.
The most important point is that descriptions are expressed in the same structure, then, we will know where to look at for what information.
Certainly, some people will prefer different structures than ours, but even if they dislike our structure, still, they will know where to look at for what information.
An idea is that all the entities in the proposition are listed in the 1st block and the statements are listed in the 2nd block. Then, we will easily comprehend what entities are involved in the proposition.
Each block should be visually kind. For example, the entities should be listed line by line, which will help the reader to grasp the entities promptly or to look up an entity while looking at the statements; any 2 statements should not be in the same line and the logical connection ('
Another idea is that notations are concise and consistent. For example, should we write "
Although at first one was thinking of only Structured Descriptions of propositions, but one has extended it also to Structured Descriptions of definitions. Certainly, many simple definitions do not particularly necessitate Structured Descriptions, but some complicated definitions could use it.
Structured Description is logically complete, which means that no information is lacking compared with Natural Language Description.
So, Structured Description is self-sufficient without Natural Language Description, and while we may show both for a little while, Natural Language Description will be dismissed eventually, probably.
2: The Rules of Structured Descriptions of Propositions
As the 1st rule, the author has the discretion to break some rules in order to realize better readability, because the whole purpose is better readability but not observing the rules.
This is an example.
Entities:
//
Statements:
//
The entities are listed line by line.
Sometimes, one wonders whether one should list an entity in the Entities block: for example, should
"
"
The "//" marks denote the ends of the blocks, which may seem to be unnecessary if nothing is inserted between the blocks and something after the Statements block is guaranteed to not be confused to be a part of the Statements block, but as one expects some cases like a comment is inserted between the blocks, the marks stay.
Although the Statements block above has only 1 statement, when it has multiple statements some of which are conditional ones, it will be like this.
Statements:
(
~
~
)
~
//
The implication direction mark, "
Any number of parentheses can be used in order to avoid any ambiguity. One always uses "
3: The Rules of Structured Descriptions of Definitions
The rules of Structured Descriptions of definitions are almost the same with the ones of Structured Descriptions of propositions, but there are some differences.
Structured Description of any definition has the Conditions block instead of Statements block.
This is an example.
Entities:
//
Conditions:
//
While there can be multiple concerned entities, only one of them is the entity defined in the definition, and the entity is indicated by "*".
4: It is Work in Progress
This is an attempt to make descriptions of definitions and propositions to be comprehended more promptly, and one knows that the rules will be improved as one writes and reads descriptions.