Wiki Cleanup

From OWASP
Revision as of 16:36, 3 June 2014 by Jmanico (Talk | contribs)

Jump to: navigation, search
[edit]

Why are you here? Because you are one of the brave souls who wants to help clean up the OWASP wiki. This not a task for the mild mannered or the weak hearted. This task is for the intellectual juggernaut, the mentally brave, and those who only grunt their teeth and dig in when faced with a mountain of outdated and disorganized wiki pages.

  1. Please start by reading some of the wiki-editors archive http://lists.owasp.org/pipermail/owasp-wiki-editors/ to see our conversations and how our decisions evolved.
  2. Next, please review the content labeling template intended for labeling content that needs updating or removal. https://www.owasp.org/index.php/Template:TaggedDocument Content that needs updating or removal can be flagged with one of several categories:
    1. inactiveDraft - draft content that was never finished
    2. old or partialOld- old content that needs updating
    3. historical - out of date but archived for historical context
    4. merge - duplicate content that needs to be merged with another doc
    5. pls_review - recently updated, requesting review
    6. delete - recommended for permanent deletion
    7. (tagged with no attribution) generic tagged for review - unsure whats wrong, but needs someone to look at it
    8. We also have a "popular" category to label up to date content that still needs frequent review. https://www.owasp.org/index.php/Category:Popular
  3. As you move forward and work on content, some wiki pages just need to be tagged in some way, some wiki pages will need to REDIRECTED to other more relevant content, some wiki pages content great but incomplete work and will need to be finished or updated in some way.
  4. Also consider just grinding through the FixME pages - lots of deprecated content here that needs tagging. https://www.owasp.org/index.php/Category:FIXME
  5. Anther approach is to hit google for different OWASP projects and see what pops up first, and update or deprecate those pages so we can clean up more higher priority items.
  6. Another approach is to pick a topic (like XSS, or SQL Injection) and search for all pages on those items, and see if anything can be merged. Post anything you find to the owasp-wiki-editors list.
  7. If you see duplicate content, consider merging into one page and redirect one to the other. Redirecting is better than deleting since it preserves search engine points of entry.
  8. This is still a work in progress, so please any other advice here is appreciated. Join us at https://lists.owasp.org/mailman/listinfo/owasp-wiki-editors !

  1. What's the problem (describe a few google searches that lead to out of date OWASP wiki pages)
    1. https://www.google.com/search?q=top+10+owasp+attacks+xss: Shows links to 2013, 2010, and 2007 T10
    2. https://www.owasp.org/index.php?search=malicious&title=Special%3ASearch: Shows 2007 T10 hits
  2. What's some good ways to keep an eye on this better moving forward (like tagging popular pages for more careful review)
  3. Describe the tagging system for legacy, dead or good content content that needs updating, etc...
  4. Describe a few search mechanisms to find content that needs review and tagging
  5. Leverage the community to help us update the wiki!