Children Display |
---|
Panel | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Creating and naming examples Create each example on a new page and assign it a working name as the page's title. The name will not appear in the published document, so it can be whatever you want (within reason), as long as it will let you and others on the team easily identify which example you're talking about during the course of development, without having to go look it up. In general, this means a relatively short name with a minimum of redundancy. For example, "Frame shift", "HBB", and "Microarray" are much more descriptive than "PF 3", "PF 6", and "PF 10", which in turn are more descriptive than "Section 4.1.3 Example 3", "Section 4.1.3 Example 6", and "Section 4.1.3 Example 10". If the page ID is visible in the URL even in view mode, then the title contains a problematic character, but the only absolutely forbidden character is the colon ( : ), which will keep include macros from being able to find it properly. Page templates you can use:
Labels Labels are space-delimited and lower case. Use a hyphen ( - ) to substitute for a space within a label. Reuse existing labels where possible, but don't feel limited if a new label would be more accurate. Each example should be labeled with:
For example, the "HBB" example mentioned above could be labeled: example sdtm pgx genetic-variation zygosity hemoglobin-beta sanger-sequencing pfallelc xnam refseq rsnum frame-shift sickle-cell-anemia |
...