viathinksoft-std-0001-std.txt

 



VIATHINKSOFT/WEBFAN                                         D. Marschall
SPECIFICATION No. 1                                         ViaThinkSoft
First Draft: 2024                                      17 September 2024


           === ViaThinkSoft/Webfan Standard Specification ===

Abstract

   This document describes how the standards for ViaThinkSoft and Webfan
   are defined, written, and published.

Identification of this Document

   Revision:  2024-09-17
   State:     In Force
   Filename:  viathinksoft-std-0001-std.txt
   URN:       urn:x-viathinksoft:std:0001:2024-09-17
   OID:       1.3.6.1.4.1.37476.3.0.0
              { iso(1) identified-organization(3) dod(6) internet(1)
                private(4) enterprise(1) 37476 specifications(3)
                misc(0) viathinksoft-webfan-standard(0) }
   WEID:      weid:pen:SX0-3-0-0-5
   IETF/RFC:  (None)

Attachments

   (None)

Copyright Notice

   Copyright (c) 2024 ViaThinkSoft and the persons identified as the
   document authors.  All rights reserved.

   Licensed under the terms of the Apache 2.0 License.













 


Marschall                                                       [Page 1]

VTS/WF STD. 1               VTS/WF Standards           17 September 2024


Table of Contents

   1  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .  3
     1.1  Terminology . . . . . . . . . . . . . . . . . . . . . . . .  3
     1.2  General Rules . . . . . . . . . . . . . . . . . . . . . . .  3
   2  Tool Chain  . . . . . . . . . . . . . . . . . . . . . . . . . .  3
   3  General Structure . . . . . . . . . . . . . . . . . . . . . . .  3
     3.1  First Page Structure  . . . . . . . . . . . . . . . . . . .  4
     3.2  Other Pages Structure . . . . . . . . . . . . . . . . . . .  5
     3.3  Document Structure  . . . . . . . . . . . . . . . . . . . .  5
   4  Security Considerations . . . . . . . . . . . . . . . . . . . .  5
   5  RA Considerations . . . . . . . . . . . . . . . . . . . . . . .  5
   6  References  . . . . . . . . . . . . . . . . . . . . . . . . . .  6
     6.1  Normative References  . . . . . . . . . . . . . . . . . . .  6
     6.2  Informative References  . . . . . . . . . . . . . . . . . .  6
   Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . .  6
   Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . .  6































 


Marschall                                                       [Page 2]

VTS/WF STD. 1               VTS/WF Standards           17 September 2024


1  Introduction

   The current standards are published here: 
   https://viathinksoft.de/std/

   The source files are published at GitHub: 
   https://github.com/ViaThinkSoft/standards

1.1  Terminology

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
   "OPTIONAL" in this document are to be interpreted as described in
   BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all
   capitals, as shown here.

1.2  General Rules

   Each document receives a sequential number.

   Documents can be changed (unless RFCs).  If the change is minor
   (like, fixing a typo), the revision date does not need to be changed.

   Each document can be identified with the URN "urn:x-
   viathinksoft:std:<nnnn>:<yyyy-mm-dd>".  This URN can be extended by
   components (delimited with colon), e.g. to get an URN for a XML
   schema identifier.  The prefix "x-" for the second URN component
   defines an experimental namespace not registered at IANA, as defined
   in [RFC 3406], section 3.1.

2  Tool Chain

   The documents should be written in Nroff Internet Draft Editor by 3xA
   Security. It can be downloaded here:
   https://aaa-sec.com/nroffedit/
   https://misc.daniel-marschall.de/patches/nroffedit/ ("year 2020"
   patch)

3  General Structure

   The overall structure, style, and look-and-feel of a
   ViaThinkSoft/Webfan standard should be similar to the IETF Internet
   Drafts.  Note that the documentation and style of some standards are
   not yet done, and hence these standards look a bit "rough" and a lot
   of IETF rules are currently broken.

   A key difference between an IETF Internet Draft and a VTS/WF Standard
   is the first page and the header and footer lines of the pages.
 


Marschall                                                       [Page 3]

VTS/WF STD. 1               VTS/WF Standards           17 September 2024


3.1  First Page Structure

   Title Page Header Left Top:
   - Line 1:  VIATHINKSOFT/WEBFAN
   - Line 2:  SPECIFICATION No. <Number>
   - Line 3:  First Draft: <Date>

   Title Page Header Center:
   - Empty

   Title Page Header Right Top:
   - Line 1:  Main Author(s)
   - Line 2:  Organization (ViaThinkSoft or Webfan)
   - Line 3:  Current Revision <Date>

   "Title" (Short title, not a sentence)

   "Identification of this Document"
   - Line 1:  "Revision" in format yyyy-mm-dd
   - Line 2:  "State" is either "In Force" or
                                "Work In Progress" or
                                "Deprecated"
   - Line 3:  "Filename" is the name of the TXT file.
   - Line 4:  "URN" is urn:x-viathinksoft:std:<nnnn>:<yyyy-mm-dd>
   - Line 5:  "OID" is the base OID of the standard,
              in dot-notation and ASN.1 notation
   - Line 6:  "WEID" is the WEID notation of the base OID of the
              standard.
   - Line 7:  "IETF/RFC" is filled with the RFC or I-D name, in
              case this revision is in-sync with IETF.

   "Attachments"
   - Either "(None)" or a list of titles and their URLs

   "Copyright Notice"
   - Should be an OSS license like Apache 2

   Footer Left:
   - Author Family Name

   Footer Center:
   - Empty

   Footer Right:
   - "[Page <n>]"



 


Marschall                                                       [Page 4]

VTS/WF STD. 1               VTS/WF Standards           17 September 2024


3.2  Other Pages Structure

   Header Left:
   - "VTS/WF STD. <n>"

   Header Center:
   - Short Title

   Header Right:
   - Current Revision Date

   Footer Left:
   - Author Family Name

   Footer Center:
   - Empty

   Footer Right:
   - "[Page <n>]"

3.3  Document Structure

   The document structure is similar to the structure of a RFC /
   Internet Draft, with the difference that the section "IANA
   Considerations" is replaced with "RA Considerations".  These RA
   considerations (usually OID Allocations that consists of OID, WEID,
   ASN1, and IRI) are definitions that shall be entered in the OIDplus
   Database of ViaThinkSoft and/or Webfan.


4  Security Considerations

   None.


5  RA Considerations

   OID:  1.3.6.1.4.1.37476.3.0.0
   WEID: weid:pen:SX0-3-0-0-5
   ASN1: { iso(1) identified-organization(3) dod(6) internet(1)
   private(4) enterprise(1) 37476 specifications(3) misc(0)
   viathinksoft-webfan-standard(0) }
   IRI:  /.../Specifications/Misc/ViaThinkSoft-Webfan-Standard





 


Marschall                                                       [Page 5]

VTS/WF STD. 1               VTS/WF Standards           17 September 2024


6  References

6.1  Normative References

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119,
              DOI 10.17487/RFC2119, March 1997,
              <https://www.rfc-editor.org/info/rfc2119>.

   [RFC3406]  Daigle, L., van Gulik, D., Iannella, R., and P. Faltstrom,
              "Uniform Resource Names (URN) Namespace Definition
              Mechanisms", RFC 3406, DOI 10.17487/RFC3406, October 2002,
              <https://www.rfc-editor.org/info/rfc3406>.

6.2  Informative References

   None

Acknowledgements

   I would like to thank Melanie Wehowski for her long time support in
   OIDplus and WEID projects.

   This document was written in Nroff Internet Draft Editor by 3xA
   Security.
   https://aaa-sec.com/nroffedit/
   https://misc.daniel-marschall.de/patches/nroffedit/ ("year 2020"
   patch)

Authors' Addresses

   Daniel Marschall
   Postfach 11 53
   69243 Bammental
   Germany

   Email: daniel-marschall@viathinksoft.de
   URI:   https://www.viathinksoft.com/













Marschall                                                       [Page 6]