Re: [oslc-core] Review of csprd files

[Chet Ensign <chet.ensign@oasis-open.org>]

Hi Martin - 

On Thu, May 26, 2016 at 4:37 PM, Sarabura, Martin <msarabura@ptc.com> wrote:

1. Just confirming: The references at the outset are currently 404: http://docs.oasis-open.org/oslc-core/oslc-core/v3.0/csprd01/part1-overview/oslc-core-v3.0-csprd01-part1-

overview.html

http://docs.oasis-open.org/oslc-core/oslc-core/v3.0/csprd01/part1-overview/oslc-core-v3.0-csprd01-part1-

overview.pdf

That is correct. I gave Jim the URLs that spec will publish to when we load it to docs.oasis-open.org.  

 

Should we assume the links will be fixed when we actually publish?

Yes - because those URLs are exactly where the different parts will be loaded.  

 

2. In the PDF overview document, clicking on most hyperlinks that wrap around to the next line will direct your browser to the URL corresponding to the first line - the second line is ignored. The one exception seems to be hyperlinks that break at a dash character. Thus in this example:

OSLC Core Version 3.0. Part 1: Overview (this document). http://docs.oasis-open.org/oslc-

core/oslccore/v3.0/csprd01/part1-overview/oslc-core-v3.0-csprd01-part1-overview.html

OSLC Core Version 3.0. Part 2: Discovery. http://docs.oasis-open.org/oslc-core/oslc-core/v3.0/csprd01

/part2-discovery/oslc-core-v3.0-csprd01-part2-discovery.html

 

The first hyperlink is correct and the second one is only http://docs.oasis-open.org/oslc-core/oslc-core/v3.0/csprd01

There are many instances of this behavior.

 

3. Some hyperlink references are not apparently wired up as hyperlinks in the PDF overview document, for example the reference to Resource Preview in section 4.7, Delegated Dialogs in 4.8, etc. It would appear that your PDF generator does not recognize a hyperlink as such unless it is explicitly spelled out in the html as http://.... That is, <a href="" href="http://example.com" target="_blank">http://example.com>example.com</a> will not create a hyperlink in the PDF while <a href="" href="http://example.com" target="_blank">http://example.com>http://example.com</a> will create one. This seems to be true for every single PDF document.

 

4. The font sizes in the overview PDF document are larger than those in all the other PDF documents.

 

The HTML documents seem just fine.

Regards,

Martin

 

 

 

--

/chet 
----------------
Chet Ensign
Director of Standards Development and TC Administration 
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393