How to Tag
In CYTOPATHNET pages can be "tagged" internally (to the wiki) by simply linking to the page which names the category or status you wish to apply. It is a simple, fast and effective way to keep track of things like publication status. This has been dubbed the Backlinks to index? method, since it uses the BacklinksPlugin? to achieve a category or status index.
To do so, you would edit the page and add
Tagging like this will notify other users who are watching the Publication Status page that refactoring help is needed.
Editors can use and create tags to index what work needs to be done on each page. As pages move through the Publication Lifecycle, their status changes. When they are complete and in production, the tags are removed. It's important to tag things properly, so that you communicate clearly with your fellow editors.
Tags are always placed inside of a text box to call attention to them like this:
Use your tag in a sentence, and add a sentence or two about why you placed the tag, like this:
The stub tag is placed at the top of an otherwise empty page, it should always invite participation to complete it with a link to the Welcome Authors page, like this:
The Refactor tag is a request to make substantial changes to a page. It should be placed at the top of the page. The tag should include the reasons why the change is needed. For example:
The Screenshot tag is also a request for a change. It should be placed
- just before the screenshot that needs to be replaced
- at the point where a screenshot needs to be created
This tag should also include the reason why a change is needed. For example:
The Structure tag is a request to add a page to a publication structure, so it will be included in Table of Contents and PDF's created from those structures. When you use this tag, please place it at the top of the page and indicate which structure the page should be added to, like this:
If you think that you have found errors in the document, place an error tag at the point where the error was found, with an explanation of the error:
This tag is used many times in the Publication Lifecycle:
- After new publication is created
- After screenshots have been added or replaced
- After errors have been corrected
- After refactoring
In short, after every major edit the publication should go back to needs review status. Please give a brief description of what was changed to save the review editor the time of digging through page history, like this:
The help feature is used to tag a feature or setting that requires more info from a developer or more experienced user. Place the tag at the point where help is needed. If you are tagging at item inside a wiki table, place a tag in the table at the spot you need help and put a box underneath the table:
|Upper Case Allowed?||Allows upper case if checked|
|Superformat?||I need help understanding what superformat does|
If you feel a page needs to be worked on ahead of others, you can tag it as urgent. Valid reasons for using urgent would be highly used page with errors, key new feature, security info, etc. There's no guarantee the other editors will share your sense of urgency, so it's best to edit the page yourself. Please add the urgent tag at the top of the page.
Review for Next Release
This tag is a note that the page needs to be updated or constructed for the next version of CYTOPATHNET. Place this tag along with others on the page to indicate the page needs to be edited soon.
Creating New Tags
Tags can be created for any reason, but realistically only the top 10 or so will make it on the Publication Status page - and thus be watched. Other similar Dashboard? pages can be created however for special projects. If you'd like to implement a new tag, you should first tag the tag by linking it to tag. Get it?
Please consult with the Editorial Board? before you set new tags up.
Contributors to this page: admin
Page last modified on Sunday 03 of May, 2009 07:16:22 MDT by admin.
The content on this page is licensed under the terms of the Creative Commons Attribution-ShareAlike License.
- wiki page: