Help:Web portal tutorial guidelines

Revision as of 13:12, 25 July 2012

TelcoBridges support multiple versions simultaneously. We are therefore forced to maintain multiple procedures because of interface changes.This goes somewhat against the wiki philosophy where you always have the latest and the greatest.

The following naming convention takes into consideration:

• Support multiple versions of the same procedure
• Avoid duplication of the same content
• Relevant page title
• Quickly know which version a page applies

Web portal tutorial convention

The following are mandatory when describing web procedures.

Page title

• Toolpack version number are no longer in the title

Example

Toolpack:Creating_a_New_Gateway_Configuration_A

• Versions of the same page are identify with letters

First version of the procedure

Toolpack:Creating_a_New_Gateway_Configuration_A

Second version

Toolpack:Creating_a_New_Gateway_Configuration_B

Page content

• First sentence contains Toolpack version

Applies to version(s): v2.5, v2.6.

Wiki code for page that is the same for v2.5 and v2.6

=== '''''Applies to version(s): v2.5, v2.6.''''' ===

• Set display title (Note: that the version is not present)

Example for page 'Toolpack:Creating_an_IP_Port_Range_A'

{{DISPLAYTITLE:Creating an IP Port Range}}

Tips

• Split your procedures into several steps (1 form per page)

Example:Configuring the ISUP Layer

• Add screen shots with red circles or squares

Example: Creating SS7 Point Codes