Experimental Physics and
Industrial Control System

Timo Korhonen via Core-talk <[email protected]> · Wed, 10 Apr 2019 14:17:53 +0000

Hi Kay,

On 10/04/19 16:03, "Kasemir, Kay" <[email protected]> wrote:

    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.

This was not addressed at you, you used the same method that I do to find documents, called "google", and I consider that as a valid method. 

    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?

As far as I know, yes.

    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.

No, obviously not, but at least it could be a boost to do some of the most burning tasks without having to keep answering phone calls.

    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?

If there are no objections, I can try to do that during next week when we have a few days off. Impossible to do something like that in the office. As soon as it is on the new website, it can be edited relatively easily, in place and safeguarded by a review process.

Timo

    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