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

Editorial changes #37

Merged
merged 9 commits into from
Mar 21, 2024
Merged

Editorial changes #37

merged 9 commits into from
Mar 21, 2024

Conversation

mbtaylor
Copy link
Member

No description provided.

Escaping backslash is not required in \verb environment,
and shows up in both PDF and HTML output.
Arguably it should be replaced instead by "and/or" or maybe "and".
Improves PDF formatting.
For xtypes hms and dms follow the practice in the rest of the document
of noting that arraysize="*" can be replaced with definite values
if known.
Change the text in the VOSI-availability and VOSI-capabilities
sections to match the revised policy about required VOSI services
from the table in Section 2.
Remove the stanza declaring the VOSI-availability from the
VOSI-capabilities example.  The example wasn't wrong, since availability
may still optionally be present and declared, but the majority
of new services will probably not include availability,
and the example is more compact without it.
You could also do something similar in section 1.2.
Replace the text "not allowed (highly discouraged?)"
[I presume a marker for an editorial decision to be made later]
with "highly discouraged".

You could go the other way and write "not allowed" instead,
but IMO highly discouraged is good enough.
Add "where possible" to the MAXREC section in acknowledgement of
the fact that not all output formats support overflow flagging.

Add a crossreference from the Overflow section back to the MAXREC
section.
@pdowler pdowler merged commit 58137fa into ivoa-std:master Mar 21, 2024
1 check passed
@mbtaylor mbtaylor deleted the editorial branch March 22, 2024 10:02
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

Successfully merging this pull request may close these issues.

2 participants