Back to Standards index

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]