Experimental Physics and
Industrial Control System

Michael Davidsaver via Core-talk <[email protected]> · Wed, 10 Apr 2019 09:19:34 -0700

On 4/10/19 9:11 AM, Johnson, Andrew N. wrote:
> 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 <https://pandoc.org/>, 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…

In the interest of not enabling us to kick this can down the road indefinitely.

https://github.com/epics-base/pvAccessCPP/wiki/protocol

This wiki is editable by anyone with a github account.

Experimental Physics and Industrial Control System

Experimental Physics and
Industrial Control System