Add Explanation about Dynamic-Length Items and UTF-8 Data #215
Conversation
Signed-off-by: Hartanto Ario Widjaya <tanto259@users.noreply.github.com>
Signed-off-by: Hartanto Ario Widjaya <tanto259@users.noreply.github.com>
COBOL Programming Course #2 - Advanced Topics/COBOL Programming Course #2 - Advanced Topics.md
Show resolved
Hide resolved
| # Dynamic-Length Item | ||
| So far during this course, we have only explored data items that have a fixed length. In other words, you need to define the length you need for each data type. But in this section, we will explore a fairly new concept in Enterprise COBOL - dynamic-length items. | ||
|
|
||
| Enterprise COBOL v6.3 supports dynamic-length items, which are items whose logical length might change at runtime. |
There was a problem hiding this comment.
As you mentioned in the PR, much of this content is from the Enterprise COBOL for z/OS documentation - https://www.ibm.com/docs/en/cobol-zos/6.3?topic=relationships-dynamic-length-items. Let's credit this source up-front. Additionally, much of this content is identical to that source. We should either quote the source directly or construct this chapter in our own words from what we learned from the source (and still credit it).
There was a problem hiding this comment.
Sure. Would something like the Professional Manuals section on Course 1 suffice? Since I recall someone said that Course 1 was adapted from the Programming Guide
There was a problem hiding this comment.
I like the idea of including something like the Professional Manuals section of Course 1 in Course 2. I still believe that when we adapt content, we should use our own words or directly quote the source.
There was a problem hiding this comment.
Agreed. Will re-write the paragraphs on this PR sometimes this week. Additionally, I will also put the Professional Manuals section.
There was a problem hiding this comment.
Added to c81c78a. When Course 2 is finalized, might need to shift things around to tidy the placing and formatting of the Professional Manuals section.
Signed-off-by: Hartanto Ario Widjaya <tanto259@users.noreply.github.com>
Signed-off-by: Hartanto Ario Widjaya <tanto259@users.noreply.github.com>
|
@tanto259 thanks for reworking! 👍 |
Signed-off-by: Hartanto Ario Widjaya tanto259@users.noreply.github.com
This pull request adds two new feature of Enterprise COBOL v6.3 (#212) which are:
The part on UTF-8 data are minimized to prevent an overload of information to the readers, and links to the Knowledge Center is provided for those who like to seek more information.
Contents adapted from the Programming Guide and Language Reference.
These are partly added because the Lab system is using Enterprise COBOL v6.3 and that they can be quite useful to know and learn from. But they are placed on the Advanced Topic since I think they are quite unusual and new.