Help:Web portal tutorial guidelines
From TBwiki
(Difference between revisions)
(Add tips) |
(reformat tips) |
||
| Line 28: | Line 28: | ||
* '''First''' sentence contains Toolpack version | * '''First''' sentence contains Toolpack version | ||
=== '''''Applies to version(s): v2.5, v2.6.''''' === | === '''''Applies to version(s): v2.5, v2.6.''''' === | ||
| − | Wiki code | + | Wiki code for page that is the same for v2.5 and v2.6 |
<nowiki>=== '''''Applies to version(s): v2.5, v2.6.''''' ===</nowiki> | <nowiki>=== '''''Applies to version(s): v2.5, v2.6.''''' ===</nowiki> | ||
| − | * Set display title (Note that the version is not present) | + | * Set display title (Note: that the version is not present) |
| + | Example for page 'Toolpack:Creating_an_IP_Port_Range_A' | ||
<nowiki>{{DISPLAYTITLE:Creating an IP Port Range}}</nowiki> | <nowiki>{{DISPLAYTITLE:Creating an IP Port Range}}</nowiki> | ||
=== Tips === | === Tips === | ||
| − | *Split your procedures into several steps [[Web_Portal_Tutorial_Guide_v2.5#Configuring_SS7|Example:Configuring the ISUP Layer]] | + | *Split your procedures into several steps (1 form per page) |
| − | *Add screen shots with red circles or squares [[Toolpack:Creating_SS7_Point_Codes_A|Example: Creating SS7 Point Codes]] | + | [[Web_Portal_Tutorial_Guide_v2.5#Configuring_SS7|Example:Configuring the ISUP Layer]] |
| + | *Add screen shots with red circles or squares | ||
| + | [[Toolpack:Creating_SS7_Point_Codes_A|Example: Creating SS7 Point Codes]] | ||
[[Category:Help]] | [[Category:Help]] | ||
Revision as of 13:11, 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
Contents |
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
