NSIS Wiki:Tips & Rules: Difference between revisions
From NSIS Wiki
Jump to navigationJump to search
(Added "blank pages deletion" rule.) |
(Added some rules and tips.) |
||
Line 1: | Line 1: | ||
== Articles edition rules == | == Articles edition rules == | ||
=== Title of articles === | |||
*Please, don't put the version of your script on page titles. Pages with this will be renamed to their names without their version numbers. One exception to this case is relating to scripts that work only in specified versions of a program (like "MyPlugin for NSIS 2.02"). | |||
*Also, don't put parenthesis on titles except for pages which have their original names (without parenthesis) already occupied with the same name or if the plugin or program has one in their names (which is almost impossible). Parenthesis are used for extra details that are not needed but explain better the situation (like the "without parenthesis" term I used for describing "original names"). I wouldn't like details on titles, because that's the job of the page! | |||
=== Page content === | |||
*Always post something related to NSIS. Pages that are not NSIS related will be deleted. | *Always post something related to NSIS. Pages that are not NSIS related will be deleted. | ||
*Only create pages for scripts that are updated to the latest version of NSIS. If a script only works for a version of NSIS, and this is not the latest, you should mention that it won't work for the current NSIS version. An exception is when a newer NSIS version is launched after you edited the article. In this case, the NSIS version when the article was last edited will be accounted. This rule needs more improvement. | *Only create pages for scripts that are updated to the latest version of NSIS. If a script only works for a version of NSIS, and this is not the latest, you should mention that it won't work for the current NSIS version. An exception is when a newer NSIS version is launched after you edited the article. In this case, the NSIS version when the article was last edited will be accounted. This rule needs more improvement. | ||
*Don't create NSIS discussions here. That's the job for the [http://forums.winamp.com/forumdisplay.php?s=&forumid=65 NSIS Forums]. Exceptions are how the articles look and wiki services (i.e. Uploading files). | *Don't create NSIS discussions here. That's the job for the [http://forums.winamp.com/forumdisplay.php?s=&forumid=65 NSIS Forums]. Exceptions are how the articles look and wiki services (i.e. Uploading files). | ||
*Any blank pages in this wiki will be deleted. Blank pages are just to trick users into thinking there is content. | *Any blank pages in this wiki will be deleted. Blank pages are just to trick users into thinking there is content. | ||
*More to come... | *More to come... | ||
=== Page summaries === | |||
*'''Wiki bug:''' For file summaries, don't add the file description to the summary! Instead, create the file page with the details. I don't know why the summary box for file uploads is so big and why it makes the information specified part of the file page and the summaries of both the page and file. | |||
*Also, with the rule above, put the version number or the date the file was launched as the summary. That's important because the wiki allows to have a versions history of the files, thus saving older versions of files, and the date of upload is not enough for saying which version that file has. For the file dates don't create any confusion (principally if you know other languages besides English), the date format recommended is "dd mmm yyyy" where "dd" = 2-digit day, "mmm" = month name with 3 letters, and "yyyy" = 4-digit year. Separators don't need to be spaces (" "), they could be slashes ("/") or dashes ("-") for example. | |||
== Categories creation rules == | == Categories creation rules == | ||
*Don't create new categories for just your product. Instead, discuss it on [[Category talk:Browse]]. I'm coming up with alternative ways to organize wiki pages, so don't worry if your specific category doesn't exist yet. | *Don't create new categories for just your product. Instead, discuss it on [[Category talk:Browse]]. I'm coming up with alternative ways to organize wiki pages, so don't worry if your specific category doesn't exist yet. | ||
*More to come... | *More to come... | ||
== Tips == | == Tips == | ||
*You can watch your pages by clicking on "'''Watch'''" tab at the top of the page of your choice, or by checking "'''Watch this page'''" when editing the page of your choice. Every change that happens on the page will appear on "my watchlist" link on the top of any page. | *You can watch your pages by clicking on "'''Watch'''" tab at the top of the page of your choice, or by checking "'''Watch this page'''" when editing the page of your choice. Every change that happens on the page will appear on "my watchlist" link on the top of any page. | ||
*Before clicking on '''Save page''' button, always consider to '''Preview''' the page. Every change you do to the page will be marked in the '''History''' tab. | *Before clicking on '''Save page''' button, always consider to '''Preview''' the page. Every change you do to the page will be marked in the '''History''' tab. | ||
*Please, create an account here on NSIS Wiki before editing articles. If you don't, you'll be easily confused with spammers, trolls, and etc. that are out there and could banned even if you didn't intend on doing such things. That's because it's difficult to interpret if something is spam or not if you don't know how to contact the author. | *Please, create an account here on NSIS Wiki before editing articles. If you don't, you'll be easily confused with spammers, trolls, and etc. that are out there and you could be banned even if you didn't intend on doing such things. That's because it's difficult to interpret if something is spam or not if you don't know how to contact the author. | ||
*Put summaries explaining simply what you done. If you can't explain as simple as possible, just mention what is the most important thing you have done, but put something. A blank summary means no details, and thus could be a small suspicion that the user messed the page.... This goes mostly to those who didn't follow the tip about creating an account here. |
Revision as of 23:32, 28 June 2005
Articles edition rules
Title of articles
- Please, don't put the version of your script on page titles. Pages with this will be renamed to their names without their version numbers. One exception to this case is relating to scripts that work only in specified versions of a program (like "MyPlugin for NSIS 2.02").
- Also, don't put parenthesis on titles except for pages which have their original names (without parenthesis) already occupied with the same name or if the plugin or program has one in their names (which is almost impossible). Parenthesis are used for extra details that are not needed but explain better the situation (like the "without parenthesis" term I used for describing "original names"). I wouldn't like details on titles, because that's the job of the page!
Page content
- Always post something related to NSIS. Pages that are not NSIS related will be deleted.
- Only create pages for scripts that are updated to the latest version of NSIS. If a script only works for a version of NSIS, and this is not the latest, you should mention that it won't work for the current NSIS version. An exception is when a newer NSIS version is launched after you edited the article. In this case, the NSIS version when the article was last edited will be accounted. This rule needs more improvement.
- Don't create NSIS discussions here. That's the job for the NSIS Forums. Exceptions are how the articles look and wiki services (i.e. Uploading files).
- Any blank pages in this wiki will be deleted. Blank pages are just to trick users into thinking there is content.
- More to come...
Page summaries
- Wiki bug: For file summaries, don't add the file description to the summary! Instead, create the file page with the details. I don't know why the summary box for file uploads is so big and why it makes the information specified part of the file page and the summaries of both the page and file.
- Also, with the rule above, put the version number or the date the file was launched as the summary. That's important because the wiki allows to have a versions history of the files, thus saving older versions of files, and the date of upload is not enough for saying which version that file has. For the file dates don't create any confusion (principally if you know other languages besides English), the date format recommended is "dd mmm yyyy" where "dd" = 2-digit day, "mmm" = month name with 3 letters, and "yyyy" = 4-digit year. Separators don't need to be spaces (" "), they could be slashes ("/") or dashes ("-") for example.
Categories creation rules
- Don't create new categories for just your product. Instead, discuss it on Category talk:Browse. I'm coming up with alternative ways to organize wiki pages, so don't worry if your specific category doesn't exist yet.
- More to come...
Tips
- You can watch your pages by clicking on "Watch" tab at the top of the page of your choice, or by checking "Watch this page" when editing the page of your choice. Every change that happens on the page will appear on "my watchlist" link on the top of any page.
- Before clicking on Save page button, always consider to Preview the page. Every change you do to the page will be marked in the History tab.
- Please, create an account here on NSIS Wiki before editing articles. If you don't, you'll be easily confused with spammers, trolls, and etc. that are out there and you could be banned even if you didn't intend on doing such things. That's because it's difficult to interpret if something is spam or not if you don't know how to contact the author.
- Put summaries explaining simply what you done. If you can't explain as simple as possible, just mention what is the most important thing you have done, but put something. A blank summary means no details, and thus could be a small suspicion that the user messed the page.... This goes mostly to those who didn't follow the tip about creating an account here.