Re: PV Access Protocol Specification

["Johnson, Andrew N. via Core-talk" <core-talk@aps.anl.gov>]

Kay asked:

Before the ITER-EPICS-meeting, will there be a pre-meeting of core developers similar to the CS-Studio devel meeting?

No, I am unlikely to be at ITER this time, and with Michael absent and Ralph busy with final preparations for the main meeting I don't think that time/place is going to work for a core group meeting.

If ESS organizes a (5-day?) Documentathon that most of us are able to attend we could take some time in that period to have a face-to-face meeting for non-documentation topics. As a community though I believe we have quite a lot of technical debt in our core documentation that needs to be addressed, so I see that as more important right now.


Michael Davidsaver via Core-talk wrote:

Copying the content of the PVA "spec", and the NTypes doc into a wiki has long been on my TODO list.
IMO. this documentation needs to be easier to edit.  This would hopefully decrease the cost of fixing
mistakes when they are identified.  I've come across the same inconsistency wrt. size encodings.  Just
never at a time when I could/would do a mental context switch to HTML edit mode.

https://github.com/epics-base/pvDataWWW/blob/master/mainPage/pvAccess_Protocol_Specification.html

I just passed this through my installation of pandoc, which did a reasonable job on most of the file although there are some tables that will need re-creating by hand:

https://gist.github.com/anjohnson/b55b52a49e928d053ee05984b40452b0

An ideal task for someone at the Documentathon…

- Andrew

-- 
Arguing for surveillance because you have nothing to hide is no
different than making the claim, "I don't care about freedom of
speech because I have nothing to say." -- Edward Snowdon