Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ISO does not require a period following table and figure captions. #24

Open
ERyan71258 opened this issue May 25, 2023 · 5 comments
Open

Comments

@ERyan71258
Copy link

Remove the requirement for a period following table and figure captions.

@palemieux
Copy link
Member

What happens if there are two sentences in the caption?

@ERyan71258
Copy link
Author

ERyan71258 commented May 25, 2023 via email

@ERyan71258
Copy link
Author

ERyan71258 commented May 25, 2023

SMPTE can (but does not) require a period. I am still trying to determine where I found the original requirement in 2020. It may have been in an older version of ISO, not the 2021 version. I have encountered the requirement elsewhere pertaining to engineering documents.

I removed the requirement, because when I commented on it in a document, it was pointed out to me that it is not an ISO requirement. I checked and the it is not, at least not as of 2021.

We can discuss and come to an agreement as to whether or not the requirement should stay in the AG-04 or not.

@palemieux
Copy link
Member

My reasoning for requiring a period is that not requiring a period makes a special case of a single sentence caption.

@ERyan71258
Copy link
Author

For consistency, then. Valid point.

A similar case can be made one way or another for bullets, ordered lists, and descriptions in table cells. When dealing with bullets/ordered lists, I maintain the grammar format throughout the set of bullets or the list. Same with table cells, when possible. If periods or other punctuation are warranted, then I add them.

In Terms and Definitions, there is no period at the end of a definition, unless it contains more than one sentence, or actually, a phrase, plus one or more sentences. Ideally, a definition contains only one phrase that is not a sentence, and that can be dropped into a sentence in place of a term. Occasionally, however, a definition is more complex, and requires more than one sentence. So there is a similar consistency dilemma as with the captions.

There is also the question of whether or not captions, clause headings/subheadings and table column headers should be sentence case or all uppercase initial letters (except for articles and prepositions). Currently, it is author's choice. I am not advocating for a requirement, just noting.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants