| 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 <2019> 2020 2021 2022 2023 2024 2025 | Index | 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 <2019> 2020 2021 2022 2023 2024 2025 |
| <== Date ==> | <== Thread ==> |
|---|
| Subject: | Re: PV Access Protocol Specification |
| From: | Bruno Martins via Core-talk <[email protected]> |
| To: | "Kasemir, Kay" <[email protected]> |
| Cc: | "[email protected]" <[email protected]> |
| Date: | Wed, 10 Apr 2019 10:09:37 -0400 |
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.