Naming and Identification - Revision history

AbeAnderson: /* Links */

2017-10-23T20:55:43Z

Links

← Older revision		Revision as of 20:55, 23 October 2017
Line 61:		Line 61:

	=Links=		=Links=
	[[OSE Serial Numbers]]		*[[OSE Serial Numbers]]
	[[Log Naming Convention]]		*[[Log Naming Convention]]
	[[Machine Naming Convention]]		*[[Machine Naming Convention]]
	[[OSE Part Naming Convention]]		*[[OSE Part Naming Convention]]

AbeAnderson at 20:55, 23 October 2017

2017-10-23T20:55:15Z

← Older revision		Revision as of 20:55, 23 October 2017
Line 1:		Line 1:
			{{Breadcrumb\|Organization\|Standards\|Nomenclature and Taxonomy}}

	= Overview =		= Overview =

AbeAnderson at 19:40, 23 October 2017

2017-10-23T19:40:48Z

← Older revision		Revision as of 19:40, 23 October 2017
Line 1:		Line 1:
	== Overview ==		= Overview =

	This page describes the (proposal to) the GVCS naming / identification scheme. The goal of this scheme is to identify modules and machines at a precise version unambiguously.		This page describes the (proposal to) the GVCS naming / identification scheme. The goal of this scheme is to identify modules and machines at a precise version unambiguously.

	== Background ==		= Background =

	Just like in software development, GVCS machines depend on each other. The analogy goes like this: A software typically depends on a few (external) libraries at specific versions. Next, the software changes or some of the libraries change, or both. You need to keep track of that very carefully, because if you mistype one letter in the interface (= "misplace one screw hole by half an inch"), nothing works anymore. In order to master this problem, you need to fulfill these requirements: Identification, Workflow, Tools.		Just like in software development, GVCS machines depend on each other. The analogy goes like this: A software typically depends on a few (external) libraries at specific versions. Next, the software changes or some of the libraries change, or both. You need to keep track of that very carefully, because if you mistype one letter in the interface (= "misplace one screw hole by half an inch"), nothing works anymore. In order to master this problem, you need to fulfill these requirements: Identification, Workflow, Tools.

	== Example for naming convention ==		= Example for naming convention =
	The following, fictitious example shows the naming convention in action:		The following, fictitious example shows the naming convention in action:

Line 13:		Line 13:
	[https://docs.google.com/drawings/d/13kZQvjosUuLp4NEqyZh6lHIqJStpwYNiHWWXUVO2dxw/edit edit]		[https://docs.google.com/drawings/d/13kZQvjosUuLp4NEqyZh6lHIqJStpwYNiHWWXUVO2dxw/edit edit]

	== Identification ==		= Identification =

	In order to uniquely identify a machine/module at a certain state, we find that machine/module names are not enough.		In order to uniquely identify a machine/module at a certain state, we find that machine/module names are not enough.
Line 21:		Line 21:
	* '''version''': The module version is a simple number, preceded by a "v". <code>v1, v2, v3, ...</code>. Do not use any other version tags (v3.2 or 4beta).		* '''version''': The module version is a simple number, preceded by a "v". <code>v1, v2, v3, ...</code>. Do not use any other version tags (v3.2 or 4beta).

	=== Master Index ===		== Master Index ==
	''Main article: [[Master Index]]''		''Main article: [[Master Index]]''

Line 47:		Line 47:
	</pre>		</pre>

	== Workflow ==		= Workflow =

	Many people develop collaboratively and add ideas and changes. On the other hand, only the responsible person for the machine/module is allowed to update it's version number. By that, this person guarantees that everything below in the dependency tree works together.		Many people develop collaboratively and add ideas and changes. On the other hand, only the responsible person for the machine/module is allowed to update it's version number. By that, this person guarantees that everything below in the dependency tree works together.

	== Tools ==		= Tools =

	The current OSE documentation hierarchy works like this (example):		The current OSE documentation hierarchy works like this (example):
Line 57:		Line 57:
	[http://opensourceecology.org/gvcs/gvcs-machine-index/ OSE main page: Machine Index] > [http://opensourceecology.org/portfolio/ceb-press/ CEB Press]		[http://opensourceecology.org/gvcs/gvcs-machine-index/ OSE main page: Machine Index] > [http://opensourceecology.org/portfolio/ceb-press/ CEB Press]
	[http://opensourceecology.dozuki.com/c/CEB_Press Dozuki: CEB Press] > [http://opensourceecology.dozuki.com/c/CEB_Press_-_Modules Modules] > [http://opensourceecology.dozuki.com/c/Frame Frame] > [[CEB_Press_6_-_Frame_-_Development_Board\| Wiki: Development Board]] > [[CEB_Press_6_-_Frame_Module_-_Exploded_Parts_Diagram\|Exploded_Parts_Diagram (PDF)]].		[http://opensourceecology.dozuki.com/c/CEB_Press Dozuki: CEB Press] > [http://opensourceecology.dozuki.com/c/CEB_Press_-_Modules Modules] > [http://opensourceecology.dozuki.com/c/Frame Frame] > [[CEB_Press_6_-_Frame_-_Development_Board\| Wiki: Development Board]] > [[CEB_Press_6_-_Frame_Module_-_Exploded_Parts_Diagram\|Exploded_Parts_Diagram (PDF)]].

			=Links=
			[[OSE Serial Numbers]]
			[[Log Naming Convention]]
			[[Machine Naming Convention]]
			[[OSE Part Naming Convention]]

Nathanael Wettstein: /* Identification */ link to master index, add description

2015-02-10T13:54:21Z

Identification: link to master index, add description

← Older revision		Revision as of 13:54, 10 February 2015
Line 21:		Line 21:
	* '''version''': The module version is a simple number, preceded by a "v". <code>v1, v2, v3, ...</code>. Do not use any other version tags (v3.2 or 4beta).		* '''version''': The module version is a simple number, preceded by a "v". <code>v1, v2, v3, ...</code>. Do not use any other version tags (v3.2 or 4beta).

	In more details, ~~the module and version~~ descriptions may look as follows:		=== Master Index ===
			''Main article: [[Master Index]]''

			In order to have a central reference point for unique IDs, versions and dependencies, a [[Master Index]] is proposed. This may be any sort of database which stores the following three types of data: Modules, Versions, Dependencies.

			In more details, these descriptions may look as follows:

	<pre>		<pre>

Nathanael Wettstein: /* Identification */

2015-02-06T14:10:47Z

Identification

← Older revision		Revision as of 14:10, 6 February 2015
Line 37:		Line 37:

	[dependency] What does moduleID 01, v6 depend on?		[dependency] What does moduleID 01, v6 depend on?
	- moduleID: 119		- moduleID: 119, version: v2 ("Grate")
	- version: v2		- moduleID: 121, version: v4 ("Shaker")
			- moduleID: 110, version: v1 ("Core Assembly")
	</pre>		</pre>

Nathanael Wettstein: /* Identification */

2015-02-04T20:42:05Z

Identification

← Older revision		Revision as of 20:42, 4 February 2015
Line 35:		Line 35:
	- by: John		- by: John
	- description: ...		- description: ...

			[dependency] What does moduleID 01, v6 depend on?
			- moduleID: 119
			- version: v2
	</pre>		</pre>

Nathanael Wettstein: Created page with "== Overview == This page describes the (proposal to) the GVCS naming / identification scheme. The goal of this scheme is to identify modules and machines at a precise version..."

2015-02-04T20:38:15Z

Created page with "== Overview == This page describes the (proposal to) the GVCS naming / identification scheme. The goal of this scheme is to identify modules and machines at a precise version..."

New page

== Overview ==

This page describes the (proposal to) the GVCS naming / identification scheme. The goal of this scheme is to identify modules and machines at a precise version unambiguously.

== Background ==

Just like in software development, GVCS machines depend on each other. The analogy goes like this: A software typically depends on a few (external) libraries at specific versions. Next, the software changes or some of the libraries change, or both. You need to keep track of that very carefully, because if you mistype one letter in the interface (= "misplace one screw hole by half an inch"), nothing works anymore. In order to master this problem, you need to fulfill these requirements: Identification, Workflow, Tools.

== Example for naming convention ==
The following, fictitious example shows the naming convention in action:

<html><img src="https://docs.google.com/drawings/d/13kZQvjosUuLp4NEqyZh6lHIqJStpwYNiHWWXUVO2dxw/pub?w=640&h=480"></html>
[https://docs.google.com/drawings/d/13kZQvjosUuLp4NEqyZh6lHIqJStpwYNiHWWXUVO2dxw/edit edit]

== Identification ==

In order to uniquely identify a machine/module at a certain state, we find that machine/module names are not enough.

We use the following convention: <code>moduleID, version</code>, where:
* '''moduleID''': A unique number as defined in the [[Master Index]]. Once assigned, this number never changes.
* '''version''': The module version is a simple number, preceded by a "v". <code>v1, v2, v3, ...</code>. Do not use any other version tags (v3.2 or 4beta).

In more details, the module and version descriptions may look as follows:

<pre>
[module] What is moduleID 01?
- moduleID: 01
- name: CEB Press
- alias: The Liberator, Compressed Earth Brick Press
- description: ...

[version] What is the latest version of moduleID 01?
- version: v6
- date: 2014-08-27
- by: John
- description: ...
</pre>

== Workflow ==

Many people develop collaboratively and add ideas and changes. On the other hand, only the responsible person for the machine/module is allowed to update it's version number. By that, this person guarantees that everything below in the dependency tree works together.

== Tools ==

The current OSE documentation hierarchy works like this (example):

[http://opensourceecology.org/gvcs/gvcs-machine-index/ OSE main page: Machine Index] > [http://opensourceecology.org/portfolio/ceb-press/ CEB Press]
[http://opensourceecology.dozuki.com/c/CEB_Press Dozuki: CEB Press] > [http://opensourceecology.dozuki.com/c/CEB_Press_-_Modules Modules] > [http://opensourceecology.dozuki.com/c/Frame Frame] > [[CEB_Press_6_-_Frame_-_Development_Board| Wiki: Development Board]] > [[CEB_Press_6_-_Frame_Module_-_Exploded_Parts_Diagram|Exploded_Parts_Diagram (PDF)]].