DocWiki:No Proprietary Information - Revision history

Jkratky at 14:37, 23 June 2010

2010-06-23T14:37:16Z

← Older revision		Revision as of 14:37, 23 June 2010
Line 1:		Line 1:
-	DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies.	+	DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies. Proprietary information includes Cisco or customer telephone numbers and customer network topology maps and diagrams.

	The following content has been adapted from the ''Cisco Technical Documentation Style Guide'':		The following content has been adapted from the ''Cisco Technical Documentation Style Guide'':

Fenton: Apply category

2008-12-05T22:51:13Z

Apply category

← Older revision		Revision as of 22:51, 5 December 2008
Line 124:		Line 124:
	2001:0DB8:0:1:FFFF:1234::5		2001:0DB8:0:1:FFFF:1234::5
	\|}		\|}
		+
		+	[[Category:DocWiki guidelines]]

Mguthrie at 16:19, 7 February 2008

2008-02-07T16:19:14Z

← Older revision		Revision as of 16:19, 7 February 2008
Line 1:		Line 1:
-	~~The~~ DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies.	+	DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies.

	The following content has been adapted from the ''Cisco Technical Documentation Style Guide'':		The following content has been adapted from the ''Cisco Technical Documentation Style Guide'':

Pzimmerm at 22:01, 5 February 2008

2008-02-05T22:01:21Z

← Older revision		Revision as of 22:01, 5 February 2008
Line 6:		Line 6:

	The following sections describe domain names and IP addresses that are safe to use:		The following sections describe domain names and IP addresses that are safe to use:
-
-	* Domain Names
-
-	* IP Addresses Reserved for Documentation
-
-	* Private IP Addresses
-
-	* IP Multicast Addresses
-
-	* The Loopback (or Localhost) Address
-
-	* The IPv6 Reserved Prefix

Pzimmerm at 21:05, 5 February 2008

2008-02-05T21:05:01Z

← Older revision		Revision as of 21:05, 5 February 2008
Line 1:		Line 1:
	The DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies.		The DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies.

-	The following content has been ~~modified~~ from the ''Cisco Technical Documentation Style Guide'':	+	The following content has been adapted from the ''Cisco Technical Documentation Style Guide'':

	Do not use valid or potentially valid domain names or IP addresses, including examples, command output, and sample configurations. Inadvertent use of valid domain names or IP addresses can interfere with network operation, compromise network security and privacy, or conflict with intellectual property rights.		Do not use valid or potentially valid domain names or IP addresses, including examples, command output, and sample configurations. Inadvertent use of valid domain names or IP addresses can interfere with network operation, compromise network security and privacy, or conflict with intellectual property rights.

Pzimmerm at 20:28, 5 February 2008

2008-02-05T20:28:14Z

← Older revision		Revision as of 20:28, 5 February 2008
Line 1:		Line 1:
	The DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies.		The DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies.

-	The following content ~~comes~~ from the ''Cisco Technical Documentation Style Guide'':	+	The following content has been modified from the ''Cisco Technical Documentation Style Guide'':

-	Do not use valid or potentially valid domain names or IP addresses ~~on DocWiki~~, including examples, command output, and sample configurations. Inadvertent use of valid domain names or IP addresses can interfere with network operation, compromise network security and privacy, or conflict with intellectual property rights.	+	Do not use valid or potentially valid domain names or IP addresses, including examples, command output, and sample configurations. Inadvertent use of valid domain names or IP addresses can interfere with network operation, compromise network security and privacy, or conflict with intellectual property rights.

-	The following sections describe domain names and IP addresses that are safe to use ~~on the DocWiki~~:	+	The following sections describe domain names and IP addresses that are safe to use:

	* Domain Names		* Domain Names

Pzimmerm at 20:27, 5 February 2008

2008-02-05T20:27:01Z

← Older revision		Revision as of 20:27, 5 February 2008
Line 1:		Line 1:
	The DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies.		The DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies.
		+
		+	The following content comes from the ''Cisco Technical Documentation Style Guide'':

	Do not use valid or potentially valid domain names or IP addresses on DocWiki, including examples, command output, and sample configurations. Inadvertent use of valid domain names or IP addresses can interfere with network operation, compromise network security and privacy, or conflict with intellectual property rights.		Do not use valid or potentially valid domain names or IP addresses on DocWiki, including examples, command output, and sample configurations. Inadvertent use of valid domain names or IP addresses can interfere with network operation, compromise network security and privacy, or conflict with intellectual property rights.

Pzimmerm at 19:14, 5 February 2008

2008-02-05T19:14:14Z

New page

The DocWiki should not contain any proprietary information. This restriction includes both Cisco-specific content and material from other companies.

Do not use valid or potentially valid domain names or IP addresses on DocWiki, including examples, command output, and sample configurations. Inadvertent use of valid domain names or IP addresses can interfere with network operation, compromise network security and privacy, or conflict with intellectual property rights.

The following sections describe domain names and IP addresses that are safe to use on the DocWiki:

* Domain Names

* IP Addresses Reserved for Documentation

* Private IP Addresses

* IP Multicast Addresses

* The Loopback (or Localhost) Address

* The IPv6 Reserved Prefix

== Domain Names ==

[http://www.ietf.org/rfc/rfc2606.txt?number=2606 RFC 2606] reserves the top-level domain .example for use in documentation or examples of code. The second-level domain names example.com, example.org, and example.net are also reserved for use as examples.

== IP Addresses Reserved for Documentation ==

[http://www.ietf.org/rfc/rfc3330.txt?number=3330 RFC 3330] assigns the address block 192.0.2.0/24 for use in documentation and examples of code.

== Private IP Addresses ==

[http://www.ietf.org/rfc/rfc1918.txt?number=1918 RFC 1918] provides a group of IP addresses that are never assigned publicly and are not routed through the public Internet. The same pool of addresses can be used within any private network (a network that does not communicate with the Internet or with other private networks, or communicates only through gateways that translate the IP address). You can use these IP address ranges for hosts that do not need access to the Internet.

{| border = 1
|-
!Address Block
!Starting Address
!Ending Address
!Approximate Number of Hosts
|-
|

10.0.0.0/8
|
10.0.0.0
|
10.255.255.255
|
16,000,000
|-
|

172.16.0.0/12
|
172.16.0.0
|
172.31.255.255
|
1,000,000
|-
|

192.168.0.0/16
|
192.168.0.0
|
192.168.255.255
|
65,000
|}

== IP Multicast Addresses ==

[http://www.ietf.org/rfc/rfc1112.txt?number=1112 RFC 1112] defines the address space for IP multicast addresses, which are generally safe to use in documentation because they cannot be reserved. IP multicast group addresses range from 224.0.0.0/8 to 239.0.0.0/8.

== The Loopback (or Localhost) Address ==

By convention, most systems assign the IP address 127.0.0.1 and the name localhost to the loopback interface that allows a client and server on the same host to communicate with each other over TCP/IP. You can use the 127.0.0.1 localhost address in Cisco documentation.

== The IPv6 Reserved Prefix ==

[http://www.ietf.org/rfc/rfc3849.txt?number=3849 RFC 3849] sets aside the IPv6 address prefix 2001:0DB8::/32 for use in technical documentation. Addresses within this prefix are not routed through the public Internet.

To allow you to show complex network configurations, the IPv6 documentation prefix allows many different networks, subnetworks, and hosts. The following table shows three examples of networks within this prefix and a host address on each network. The table uses the following standard notation:

* An IPv6 address consists of eight blocks, separated by colons.

* Each block contains four hexadecimal numbers (16 bits).

* Leading zeros within a block can be omitted.

* A double colon (::) means that two or more consecutive blocks of 0000 have been omitted. This notation can be used only once per IPv6 address. The number of blocks omitted can be calculated from the number remaining.

* A slash followed by a number (/n) means that the number of bits indicated do not change. For example, /48 means that the first 48 bits (three blocks) do not change.

{| border = 1
|-
!Network Prefix
!Starting Address
!Ending Address
!Example Host
|-
|

2001:0DB8::/48
|
2001:0DB8::1
|
2001:0DB8:0:FFFF: ... :FFFE
|
2001:0DB8:0:ABCD::1
|-
|

2001:0DB8::/64
|
2001:0DB8::1
|
2001:0DB8:0:0:FFFF: ... :FFFE
|
2001:0DB8:0:0:E000::F
|-
|

2001:0DB8:0:1::/64
|
2001:0DB8:0:1::1
|
2001:0DB8:0:1:FFFF: ... :FFFE
|
2001:0DB8:0:1:FFFF:1234::5
|}