Experimental Physics and
Industrial Control System

"Kasemir, Kay via Core-talk" <[email protected]> · Wed, 10 Apr 2019 14:03:21 +0000

Hello Timo,

 > .. grumpy old man.
Echo that, and honored to be in your company.
I apologize for not seeing the "Resources and Support" -> "Documents" -> "pvAccess" section, that was entirely my fault.
It does point to the same document, so at least we're consist.

>  ESS is eager to support a documentathon..
Before the ITER-EPICS-meeting, will there be a pre-meeting of core developers similar to the CS-Studio devel meeting?
I'm happy to update the size encoding description in the spec, but unclear how.
At the same time, not sure if one sizable documentathon is the final solution.
I understand that a specification should be somewhat fixed, but at the same time it may have a better chance of being correct when it's in an editable form.
So use the ITER-EPICS-premeeting to copy the old spec to the new web site in a way that people with an account can then keep updating it?

Thanks,
Kay

From: Timo Korhonen <[email protected]>

I am afraid that this is the latest version of the document. The community has accumulated a lot of documentation debt. ESS is eager to support a documentathon, we are just waiting instructions on when the community would like that to happen.

By the way, reading the F2F core meeting notes, there was a mention about rescuing the documents from the old V4 site (epics-pvdata) and putting them on the new website. Nobody seems to have looked at the new website, under "Resources and Support" -> "Documents";  if you look carefully, there is an item called "pvAccess". Under that item you find links to a number of documents and even a downloadable "pvAccess Protocol Specification" pdf. I have also a similarly formatted Normative Types document but I was discouraged  from making pdf documents so it has not been put there.
Or, of course, because the website structure is "wrong", nothing can be found. The structure was modelled after the APS website and reviewed by the community. Just saying. Let us do it right, then.

Rescuing the items from the V4 site could be completed at the documentathon. Or by the numerous volunteers that will jump up to help in creating content for the new website. Next time we will give t-shirts only to people who have contributed.

Experimental Physics and Industrial Control System

Experimental Physics and
Industrial Control System