Experimental Physics and
Industrial Control System

Hi,

 

We (ESS) are happy to organize a 5-day Documentathon. Henrik promised that we can make a “nice” event; I interpret it something like “better environment than staying in a meeting room at the ESS site for a week”. Details TBD, but I agree with Andrew that it probably is best to dedicate that time to documentation.

 

Somehow I misunderstood that there would be a core developer’s meeting at ITER. Thank you for the correction.

 

Timo

(less grumpy today.)

 

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