MediaWikiRecovery: Difference between revisions

Latest revision as of 01:11, 28 August 2010

Translation

Do not translate this page into other languages. It is either low priority, too specific or incomplete.

This page is thought to give some instructions on how to help working on the Wiki recovery. As it has been written very quickly, it may have some errors, but as it is not one of the content pages, I think this shouldn't be a problem, as long as what is written here is understandable.

Objectives of Wiki recovery

By recovering the Wiki content we want to acheive the following:

recovery as much as possible
reinstate reliable content
prevent content for all system versions against loose it
clean/verify/update wiki content
make wiki better and easier than it was before
make wiki actual documentation for Shareaza

Rules for recovering

Our goal is to restore as much of content as possible. If you are going to help in this please try to follow the rules and conventions outlined below. By following these guidelines we can maximize our efficiency and maintain the quality of our wiki.

First of all: do it better, only then faster

Please always have in mind that the true quality of any documentation is determined by the USEABILITY and RELIABILITY of its content. Our primary concern is not how fast the content was written, or how much there is, regardless of how many users are waiting for it. Useless documentation will only cause people to get frustrated and leave the wiki, or even stop using Shareaza. The quality of the wiki is our strongest tool in Shareaza marketing. Please respect users and others working on wiki.

One thing belongs in one place only

Please take as a general rule "one thing is to be described in one single place (page)". If necessary it can be linked to with <code>[[linked to page name|alternative link text]]</code like in Wikipedia. This makes it easier for us to update content and also makes the Wiki easier to use.

Content about older systems

Please do not remove information about older versions of Shareaza or older operating systems that are not supported anymore, since the information might still be helpfull for some users. Rather than moving the outdated content to a new page, it is preferred to divide that part of the article into sections pertaining to each different version or operating system. These sections should be ordered by release date starting with the most recent and finishing with the oldest so that the most relevant information is at the top.

Content from last backup

If a page contains old content that could still be relevant to some users, please do not replace it with the new content, but instead merge the two whenever possible. If it is not possible to merge the two then the article may need to be divided into sections.

Reinstated structure

We try to reinstated structure, but please do not use subpages if this is not needed. This is very fancy but makes it much harder to read (for users), edit, recover, and verify information (have we recovered all and is it actual content). Translating of subpages is also more difficult when the context is lost, and in many cases subpages are untranslated orphans. Avoid it please, at least during recovery.

Comments on recovered pages

Recovered pages should begin with the Recovered template.

{{Recovered|page status message}}

If you can, please describe there the date the recovered content was last edited, and the date the content was recovered. Do not leave a date if you are unsure of it - It is better to have no date then to have a date that is wrong. This helps other people working on recovery.

If you think the whole page has been recovered please mention this, preferably with the date of the last edit on the old Wiki.

You may wish to write something like:

Recovered

The following content has been recovered from <recovery source>. Some content may be outdated, incomplete, inaccurate, or improperly formatted.

e

If you want to leave a note for yourself or for others you can add comments using the note template. The Note template, unlike the Recovered template, can be color-coded to help with organization.

{{Note|#E8F7FC|note to self or others}}

You may wish to write something like:

end of recovered content

there was no backuped content

content recovered from last available backup

Once a page has been fully updated and verifyed to match the latest version of Shareaza, it should be marked with the {{Updated|date|Shareaza version|comment}} template and be added to the list on the WikiProjects.UpdateAndVerifyPages page.

Sources

Shareaza Wiki is recovered from many sources. We recover only our own, by Shareaza community created and owned, content. Unfortunately this also means that the content have to be selected and gathered manually to be useful (bot is useless when no rules can be set), and this make it will take a longer time to obtain effects, as in total there can be even about 5000-6000 unique pages to examine and process them to become Shareaza wiki pages again.

Formatting

Seems in many cases formatting will have to be done again. Plain text is pasted in most cases.

Date of recovered content

Date mentioned in source of recovered page is placed at the end of page or in template RecoveredPage. This is date of last edition in sabotaged wiki. This is not a date of last edit in current page which is added automaticly by current wiki at the footer of any page.

Language Template Usage

The Wiki hosted on SourceForge does not support all the same functions as the old Wiki. As a result of this, we have had to modify some of the templates to make them functional again. One example is the language template. If you would like to include the language template on a page you now have to add the page name of the english page on all languages versions other than English:

Languages - This template adds a language bar to an article. The English page name is a required parameter and can only be omitted on the English page of the article.

Note that pages that are marked with the following template should not be translated into languages other than English:

Translation

Do not translate this page into other languages. It is either low priority, too specific or incomplete.

e

Sources for Shareaza Wiki recovery

This is more precisely described in this thread URGENT HELP in RECOVER SHAREAZA RESOURCES NEEDED NOW!! Sources are copies pages grabbed from any available internet service cache like eg. Google, Yahoo etc. Grabbed of course by Shareaza volunteers. Many of these files are also available from http://sure-raza.com/backups/ .

How you can help (remember: this is open source project)

The biggest problem we are facing right now is that the people who have the files do not have the time or they are not making them properly available(dead links). For this reason was set up a site where everyone can upload and download these files as they please. Everyone who has anything please take the time to upload it at http://sure-raza.com/backups/ If you do not yet have access to the shareaza wiki and you want to help then please send a PM to Cyko_01 on the forum, who will gladly give anyone edit permissions (sourceforge forces us to give edit permissions individually, but it doesn't take long).

Current Shareaza Wiki content status

August 2010

A quick update on the recovery status: Most pages that could be recovered have been; Now more work is needed on updating them. Especially some of the language versions other than English do look terrible. Also, the Wiki templates have seen major updates that improve usability and add numerous small features to them.

mfg, Old death 12:48, 16 August 2010 (UTC)

December 2009

The English version of wiki has been reinstated by December 2009 in significant part, so it seems to be useful for general use. Especially new users can find in proper form basic help and explanations useful also for 2.5.0.0. Some pages (especially those advanced or located on deeper level) are recovered, however not formatted properly but readable, sorry - this usually means they were not verified yet. New content about 2.5.0.0 version is being added and updated, so wiki is alive and in fact becomes different then it was before.
Non-English versions status depend on activity of particular language editor (also time he has devoted to edition and recovery of English version, which is priority number 1). Some looks very good, some doesn't look at all. Unfortunately, during efforts to reinstate non-English pages in very many number of cases content is empty (so lost) or contains only "TranslateMe" template. These efforts will be continued more intensively when English version reinstate will be finished and verified, so actual. Effects, if any possible, will be pasted in a form of row content as available (due to lack particular language skills) with "Recovery" template explaining situation.

August/September 2009

Current Shareaza Wiki content consist of last available for us backup and recovered pages which are being added one by one. This is backup from 2008 year so it is quite old, however can be useful. You can use it as trusted content, however have in mind it is outdated in many places. We are sorry for that, but the only way to change it is to recover lost Shareaza Wiki pages. Or get it back from person who had sabotaged it, William Shields Erwin, but that would require his good will and cooperation hence we think we can't count on this. Reasons and background are described here http://en.wikipedia.org/wiki/Shareaza.

@@ Line 1: / Line 1: @@
-{{Language}}
+{{do not translate}}
-== Aims of Shareaza Wiki recovery ==
+This page is thought to give some instructions on how to help working on the Wiki recovery. As it has been written very quickly, it may have some errors, but as it is not one of the content pages, I think this shouldn't be a problem, as long as what is written here is understandable.
-are following:
-* recovery as much as  possible
-* reinstate reliable content
-* prevent content for all system versions against loose it
-* clean/verify/update wiki content
-* make wiki better and easier than it was before
-* make wiki actual documentation for Shareaza
-== Current Shareaza Wiki content status ==
+== Objectives of Wiki recovery ==
-Current Shareaza Wiki content consist of last aviable for us backup and recovered pages which are being added one by one. This is backup from 2008 year so it is quite old, however can be useful. You can use it as trusted content, however have in mind it is outdated in many places. We are sorry for that, but the only way to change it is to recover lost Shareaza Wiki pages. Or get it back from person who had sabotaged it, William Shields Erwin, but that would require his good will and cooperation hence we think we can't count on this. Reasons and background are described here http://en.wikipedia.org/wiki/Shareaza.
+By recovering the Wiki content we want to acheive the following:
+:* recovery as much as possible
+:* reinstate reliable content
+:* prevent content for all system versions against loose it
+:* clean/verify/update wiki content
+:* make wiki better and easier than it was before
+:* make wiki actual documentation for Shareaza
+== Rules for recovering ==
+Our goal is to restore as much of content as possible. If you are going to help in this please try to follow the rules and conventions outlined below. By following these guidelines we can maximize our efficiency and maintain the quality of our wiki.
+=== First of all: do it better, only then faster ===
+Please always have in mind that the true quality of any documentation is determined by the USEABILITY and RELIABILITY of its content. Our primary concern is not how fast the content was written, or how much there is, regardless of how many users are waiting for it. Useless documentation will only cause people to get frustrated and leave the wiki, or even stop using Shareaza. The quality of the wiki is our strongest tool in Shareaza marketing. Please respect users and others working on wiki.
+=== One thing belongs in one place only ===
+Please take as a general rule "one thing is to be described in one single place (page)". If necessary it can be linked to with <nowiki><code>[[linked to page name|alternative link text]]</code</nowiki> like in Wikipedia. This makes it easier for us to update content and also makes the Wiki easier to use.
+=== Content about older systems ===
+Please do not remove information about older versions of Shareaza or older operating systems that are not supported anymore, since the information might still be helpfull for some users. Rather than moving the outdated content to a new page, it is preferred to divide that part of the article into sections pertaining to each different version or operating system. These sections should be ordered by release date starting with the most recent and finishing with the oldest so that the most relevant information is at the top.
+=== Content from last backup ===
+If a page contains old content that could still be relevant to some users, please do not '''replace''' it with the new content, but instead '''merge''' the two whenever possible. If it is not possible to merge the two then the article may need to be divided into sections.
+=== Reinstated structure ===
+We try to reinstated structure, but please do not use subpages if this is not needed. This is very fancy but makes it much harder to read (for users), edit, recover, and verify information (have we recovered all and is it actual content). Translating of subpages is also more difficult when the context is lost, and in many cases subpages are untranslated orphans. Avoid it please, at least during recovery.
-==='''Timeline'''===
+=== Comments on recovered pages ===
-'''Jul 19, 2009''' - new language templates created and implemented ( [[User:Cyko 01|Cyko 01]] )
+Recovered pages should begin with the '''[[Template:Recovered|Recovered]]''' template.
+ <nowiki>{{Recovered|page status message}}</nowiki>
-== Rules for recovering ==
+If you can, please describe there the date the recovered content was last edited, and the date the content was recovered. Do not leave a date if you are unsure of it - It is better to have no date then to have a date that is wrong. This helps other people working on recovery.
-Aim is to place as much of content as possible. If you are going to help in this please try to follow below listed general rules, otherwise we can waste lots of time and reach no effects.
-==='''Sources'''===
+If you think the whole page has been recovered please mention this, preferably with the date of the last edit on the old Wiki.
-Shareaza Wiki is recovered from many sources. We recover only our own, by Shareaza community created and owned, content. Unfortunately this also means that the content have to be selected and gathered manually to be useful (bot is useless when no rules can be set), and this make it will take a longer time to obtain effects, as in total there can be even about 5000-6000 unique pages to examine and process them to become Shareaza wiki pages again.
+'''You may wish to write something like:'''
+{{Recovered|The following content has been recovered from <recovery source>. Some content may be outdated, incomplete, inaccurate, or improperly formatted.}}
-==='''Formatting'''===
+If you want to leave a note for yourself or for others you can add comments using the note template. The '''[[Template:Note|Note]]''' template, unlike the '''[[Template:Recovered|Recovered]]''' template, can be color-coded to help with organization.
-Seems in many cases formatting will have to be done again. Plain text is pasted in most cases.
+ <nowiki>{{Note|#E8F7FC|note to self or others}}</nowiki>
+'''You may wish to write something like:'''
+{{Note|#F5FFFA|end of recovered content}}
+{{Note|#E8F7FC|there was no backuped content}}
+{{Note|LightPink|content recovered from last available backup}}
-==='''Date of recovered content'''===
+Once a page has been fully updated and verifyed to match the latest version of Shareaza, it should be marked with the <code><nowiki>{{Updated|date|Shareaza version|comment}}</nowiki></code> template and be added to the list on the [[WikiProjects.UpdateAndVerifyPages]] page.
-Date mentioned in source of recovered page is placed at the end. This is date of last edition in sabotaged wiki.
-==='''Reinstated structure'''===
+=== Sources ===
-We try to reinstated structure, but please do not use subpages if this is not need. This is very fancy but make much more difficult reading (for users), editing, recovering, and verification (have we recovered all and is it actual content) . Also translating of subpages is more difficult when context is lost, and in many cases subpages are untranslated orphans. Avoid it please, at last during recovery.
+Shareaza Wiki is recovered from many sources. We recover only our own, by Shareaza community created and owned, content. Unfortunately this also means that the content have to be selected and gathered manually to be useful (bot is useless when no rules can be set), and this make it will take a longer time to obtain effects, as in total there can be even about 5000-6000 unique pages to examine and process them to become Shareaza wiki pages again.
-==='''Language Template Usage'''===
+=== Formatting ===
-The wiki hosted on sourcefroge does not support all the same functions as the old wiki. One example of this is the #if function. The result of this is that the language template used on almost every page is now broken on many pages. In order to fix as many pages as possible with as little work required the following steps are necessary:
+Seems in many cases formatting will have to be done again. Plain text is pasted in most cases.
-'''1)''' parser functions have been removed - if a page is not available it will be listed anyways and the link will be red (allowing for the creation of a new page at that location)<br>
+=== Date of recovered content ===
-'''2)''' The page name is now a required parameter - this will make the template work only on the translated pages, but since there are far more translated pages then english pages this is the best method to correct the problem<br>
+Date mentioned in source of recovered page is placed at the end of page or in template RecoveredPage. This is date of last edition in sabotaged wiki. This is not a date of last edit in current page which is added automaticly by current wiki at the footer of any page.
-'''3)''' creation of a new "language" template - this is intended to be used only on english pages as it will not support the pagename parameter. This will make it much easier to correct the broken language template on english pages
-==='''One thing in one place only, in the whole Wiki'''===
+=== Language Template Usage ===
-Please take as a general rule "one thing is to be described in one place (page)". If it is needed should be linked with "[ [  name_of_wiki_page ] ]" like in Wikipedia. It will allow to make updates in one place only and will make whole Wiki more actual and easy to use.
+The Wiki hosted on SourceForge does not support all the same functions as the old Wiki. As a result of this, we have had to modify some of the templates to make them functional again. One example is the language template. If you would like to include the language template on a page you now have to add the page name of the english page on all languages versions other than English:
-==='''Content about older systems'''===
+:'''[[Template:Languages|Languages]]''' - This template adds a language bar to an article. The English page name is a required parameter and can only be omitted on the English page of the article.
-Please do not remove parts about older system versions, they are needed for many users, but add info about newer and mark them as such. Also please do not move it to subpages. Order of versions is following: more actual system related go first. So,first goes: W7 > XP > Me > Win2k > 98. If something is system related point it directly, as users usually when "system" is mentioned think "my system, the one I have", and it could what any system.
-==='''Content from last backup'''===
+Note that pages that are marked with the following template should not be translated into languages other than English:
-If there was a content from backup at page it has been moved below pasted recovered content for verification purposes. It was indicated with comments.
+{{do not translate}}
-==='''Comments at recovered pages'''===
+== Sources for Shareaza Wiki recovery ==
-Recovered pages have below listed comments. Please use them if you are going to add any recovered content.
+This is more precisely described in this thread [https://sourceforge.net/apps/phpbb/shareaza/viewtopic.php?f=2&t=39 URGENT HELP in RECOVER SHAREAZA RESOURCES NEEDED NOW!!] Sources are copies pages grabbed from any available internet service cache like eg. Google, Yahoo etc. Grabbed of course by Shareaza volunteers. Many of these files are also available from http://sure-raza.com/backups/ .
-At the beginning of recovery content:
-<Start of recovered content from sabotaged pp.net. It need to be verified and updated if needed. If there was any backuped content aviable it will be bellow recovered content for verification purposes. Please do not remove parts about older system versions, they are needed for many users, but add info about newer and mark them as such. This info should be removed after that verification and update, but only when this page in this language version will be actual and ready to use.>
+== How you can help (remember: this is open source project) ==
+The biggest problem we are facing right now is that the people who have the files do not have the time or they are not making them properly available(dead links). For this reason was set up a site where everyone can upload and download these files as they please.
+Everyone who has anything please take the time to upload it at http://sure-raza.com/backups/
+If you do not yet have access to the shareaza wiki and you want to help then please send a PM to [http://sourceforge.net/apps/phpbb/shareaza/memberlist.php?mode=viewprofile&u=74 Cyko_01] on the forum, who will gladly give '''anyone''' edit permissions (sourceforge forces us to give edit permissions individually, but it doesn't take long).
-At the end of recovered content:
+== Current Shareaza Wiki content status ==
-<end of recovered content>
+=== August 2010 ===
+A quick update on the recovery status: Most pages that could be recovered have been; Now more work is needed on updating them. Especially some of the language versions other than English do look terrible. Also, the Wiki templates have seen major updates that improve usability and add numerous small features to them.
+: mfg, [[User:Old death|Old death]] 12:48, 16 August 2010 (UTC)
+=== December 2009 ===
+* The English version of wiki has been reinstated by December 2009 in significant part, so it seems to be useful for general use. Especially new users can find in proper form basic help and explanations useful also for 2.5.0.0. Some pages (especially those advanced or located on deeper level) are recovered, however not formatted properly but readable, sorry - this usually means they were not verified yet. New content about 2.5.0.0 version is being added and updated, so wiki is alive and in fact becomes different then it was before.
+* Non-English versions status depend on activity of particular language editor (also time he has devoted to edition and recovery of English version, which is priority number 1). Some looks very good, some doesn't look at all. Unfortunately, during efforts to reinstate non-English pages in very many number of cases content is empty (so lost) or contains only "TranslateMe" template. These efforts will be continued more intensively when English version reinstate will be finished and verified, so actual. Effects, if any possible, will be pasted in a form of row content as available (due to lack particular language skills) with "Recovery" template explaining situation.
-<there was no backuped content>
+=== August/September 2009 ===
-or
+Current Shareaza Wiki content consist of last available for us backup and recovered pages which are being added one by one. This is backup from 2008 year so it is quite old, however can be useful. You can use it as trusted content, however have in mind it is outdated in many places. We are sorry for that, but the only way to change it is to recover lost Shareaza Wiki pages. Or get it back from person who had sabotaged it, William Shields Erwin, but that would require his good will and cooperation hence we think we can't count on this. Reasons and background are described here http://en.wikipedia.org/wiki/Shareaza.
-<content recovered from last aviable backup>
-=List of recovered pages=
+== List of recovered pages ==
-[[Recovered pages list]]
+* [[Recovered pages list]]
+* [[WikiProjects.UpdateAndVerifyPages]]