Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
[sparkplug-dev] Upcoming Sparkplug Specification Meeting Tuesday, Nov 3 2020
All,

In preparation for our meeting on Tuesday, Nov 3rd, I've taken the work done by Dominik Obermaier and expanded on it. Taking some of the advice provided Ivar Grimstad, I've created stubbed out .adoc files for each of the chapters in the new table of contents. These files (per https://github.com/eclipse/sparkplug/pull/30) are now:

specification/Sparkplug_0_TOC.adoc
specification/Sparkplug_1_Introduction.adoc
specification/Sparkplug_2_Principles.adoc
specification/Sparkplug_3_Components.adoc
specification/Sparkplug_4_Topics.adoc
specification/Sparkplug_5_Messages.adoc
specification/Sparkplug_6_Message_Flow.adoc
specification/Sparkplug_7_Data.adoc
specification/Sparkplug_8_Security.adoc
specification/Sparkplug_9_HA.adoc
specification/Sparkplug_10_Acknowledgements.adoc
specification/Sparkplug_11_Appendix.adoc

I also took the opportunity to add the required legal notices/files per Eclipse rules in https://github.com/eclipse/sparkplug/issues/8.

Many of these chapters more or less align with those in the original specification. So, I would like to propose that we each pick up at least one of these new issues corresponding to the work of moving the information from the old specification into the newly created documents. Some of the new chapters/sections don't correspond exactly to old portions of the specification. I would recommend reviewing the old specification and the new chapters and closing one that you think you can tackle - or at least most of it. Once you select one, assign it to yourself in Github so nobody else picks it up and duplicates work.

https://github.com/eclipse/sparkplug/issues/31
https://github.com/eclipse/sparkplug/issues/32
https://github.com/eclipse/sparkplug/issues/33
https://github.com/eclipse/sparkplug/issues/34
https://github.com/eclipse/sparkplug/issues/35
https://github.com/eclipse/sparkplug/issues/36
https://github.com/eclipse/sparkplug/issues/37
https://github.com/eclipse/sparkplug/issues/38
https://github.com/eclipse/sparkplug/issues/39
https://github.com/eclipse/sparkplug/issues/40
https://github.com/eclipse/sparkplug/issues/41

We'll keep communication open on the Slack technical channel to address questions as they come up for all of this work.

For doing this work, I would highly suggest using the Eclipse IDE (https://www.eclipse.org/ide/) and the Asciidoctor editor/plugin for Eclipse: (https://marketplace.eclipse.org/content/asciidoctor-editor). This provides a good environment in which to work with .adoc files. There are also a number of Asciidoc reference guides on the internet including this one: https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/.

In addition to doing this specification work, I would also like to pick one normative statement to create an 'entire flow' from the specification, to the annotation, to the 'test' that covers it in the TCK. By creating an end-to-end flow we should be able to use the same pattern for all of the TCK development. I'd like to make sure we all understand this model so we can incorporate it as we go along.

Talk to you Tuesday!

Regards,
Wes


Meeting details:
IoT Meeting is inviting you to a scheduled Zoom meeting.

Topic: Eclipse Sparkplug Specification Project
Time: Sep 22, 2020 09:00 AM Pacific Time (US and Canada)
        Every 2 weeks on Tue, until Dec 1, 2020, 6 occurrence(s)
        Nov 3, 2020 09:00 AM
        Nov 17, 2020 09:00 AM
        Dec 1, 2020 09:00 AM
Please download and import the following iCalendar (.ics) files to your calendar system.
Weekly: https://eclipse.zoom.us/meeting/tJckduqprzkqHNYoI_M_VcO3fg1Hiy-IKgbe/ics?icsToken=98tyKuCrpzopG9WXsB-FRowqHYj4b-vzmHpfgo1kkzbaLh9lYSylMOUTGrtmXfH7

Join Zoom Meeting
https://eclipse.zoom.us/j/93913112062

Meeting ID: 939 1311 2062
One tap mobile
+16699006833,,93913112062# US (San Jose)
+12532158782,,93913112062# US (Tacoma)

Dial by your location
        +1 669 900 6833 US (San Jose)
        +1 253 215 8782 US (Tacoma)
        +1 346 248 7799 US (Houston)
        +1 646 876 9923 US (New York)
        +1 301 715 8592 US (Germantown)
        +1 312 626 6799 US (Chicago)
        +1 587 328 1099 Canada
        +1 647 374 4685 Canada
        +1 647 558 0588 Canada
        +1 778 907 2071 Canada
        +1 204 272 7920 Canada
        +1 438 809 7799 Canada
        +33 1 7095 0350 France
        +33 1 8699 5831 France
        +33 1 7037 2246 France
        +33 1 7037 9729 France
        +33 1 7095 0103 France
        +49 695 050 2596 Germany
        +49 69 7104 9922 Germany
        +49 30 5679 5800 Germany
        +49 69 3807 9883 Germany
        +44 131 460 1196 United Kingdom
        +44 203 481 5237 United Kingdom
        +44 203 481 5240 United Kingdom
        +44 203 901 7895 United Kingdom
        +44 208 080 6591 United Kingdom
        +44 208 080 6592 United Kingdom
        +44 330 088 5830 United Kingdom
        +41 31 528 09 88 Switzerland
        +41 43 210 70 42 Switzerland
        +41 43 210 71 08 Switzerland
        +41 44 529 92 72 Switzerland
        +41 22 591 00 05 Switzerland
        +41 22 591 01 56 Switzerland
        +46 8 5050 0828 Sweden
        +46 8 5050 0829 Sweden
        +46 8 5052 0017 Sweden
        +46 850 539 728 Sweden
        +46 8 4468 2488 Sweden
        +46 8 5016 3827 Sweden
        +45 32 72 80 10 Denmark
        +45 32 72 80 11 Denmark
        +45 47 37 25 75 Denmark
        +45 89 88 37 88 Denmark
        +45 32 70 12 06 Denmark
        +45 32 71 31 57 Denmark
        +31 20 794 6519 Netherlands
        +31 20 794 6520 Netherlands
        +31 20 794 7345 Netherlands
        +31 707 006 526 Netherlands
        +31 20 241 0288 Netherlands
        +31 20 794 0854 Netherlands
Meeting ID: 939 1311 2062
Find your local number: https://eclipse.zoom.us/u/ai9EwuI0u

Back to the top