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

Clarify/Expand Structural Semantics Vocabulary #266

Closed
GoogleCodeExporter opened this issue Mar 24, 2015 · 5 comments
Closed

Clarify/Expand Structural Semantics Vocabulary #266

GoogleCodeExporter opened this issue Mar 24, 2015 · 5 comments
Labels
Vocab-Structure The issue affects the Structural Semantics vocabulary

Comments

@GoogleCodeExporter
Copy link

In applying the ePub semantics it was difficult to apply some of the semantics 
due to ambiguity in how it should be applied and inconsistencies. There is also 
some room for expansion in regards to educational content.  

Examples of ambiguity and inconsistencies:
- plural froms e.g., 'practice' is singular but often there is section that 
contains review questions, need to add plural form like is done for footnotes 
or update definition to include plural
- 'note' seems to imply its only a super type for footnote and endnote. Can it 
be applied as an epub:type? How are hints, tips and warnings typically typed?
- the definition for 'marginalia' is ...a marginal note but its not part of the 
'note' class
- in general the language for application of semantics comes across as 
"rules/requirements" when I believe they are intended to be slightly less 
restrictive...possibly guidelines?

Examples of expansion for educational content:
- learning objective/learning outcome/standard
- assessment (question & answer)

The current semantics are a great start but if revised, clarified and expanded, 
it would greatly increase the ease and consistency of applying them.

Original issue reported on code.google.com by xmlstr...@gmail.com on 4 Mar 2013 at 3:48

@GoogleCodeExporter
Copy link
Author

[deleted comment]

2 similar comments
@GoogleCodeExporter
Copy link
Author

[deleted comment]

@GoogleCodeExporter
Copy link
Author

[deleted comment]

@GoogleCodeExporter
Copy link
Author

Resolution is proposed at:

https://code.google.com/p/epub-revision/wiki/R301StructureVocab

Original comment by mgarrish on 20 May 2013 at 9:48

  • Changed state: ProposedSolution

@GoogleCodeExporter
Copy link
Author

Fixed in r4635 per the wiki at 
https://code.google.com/p/epub-revision/wiki/R301StructureVocab

Original comment by mgarrish on 21 May 2013 at 9:14

  • Changed state: Done

@mattgarrish mattgarrish added Vocab-Structure The issue affects the Structural Semantics vocabulary and removed Spec-StructureVocab labels Nov 12, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Vocab-Structure The issue affects the Structural Semantics vocabulary
Projects
None yet
Development

No branches or pull requests

2 participants