Difference between revisions of "Category:OWASP Project Assessment"

From OWASP
Jump to: navigation, search
(Assessment Scale for OWASP DOCUMENTATION Projects)
(Assessment Scale for OWASP DOCUMENTATION Projects)
Line 81: Line 81:
 
  | style="width:60%; background:#e6e6e6" align="left"|
 
  | style="width:60%; background:#e6e6e6" align="left"|
 
All Beta Quality Requirements plus:
 
All Beta Quality Requirements plus:
* Document has been reviewed and updated to be consistent and not overly repetitive with all other Release Quality OWASP Documentation.
+
* Document has been reviewed accordingly to the [[OWASP Writing Style]] and updated to be consistent and not overly repetitive with all other Release Quality OWASP Documentation.
 
* Conference style Powerpoint presentation that describes the use and status of the project. (This could be used by others to discuss the project at OWASP Chapter meetings, serve as easy to review offline documentation, etc.)
 
* Conference style Powerpoint presentation that describes the use and status of the project. (This could be used by others to discuss the project at OWASP Chapter meetings, serve as easy to review offline documentation, etc.)
 
* Wiki content, if more than 30 pages, has been converted to an OWASP Book and is available for download or purchase at the [http://stores.lulu.com/owasp OWASP Lulu bookstore].
 
* Wiki content, if more than 30 pages, has been converted to an OWASP Book and is available for download or purchase at the [http://stores.lulu.com/owasp OWASP Lulu bookstore].
 +
* The referred above OWASP Book must have a table of contents that links all the wiki content together. See [[Guide Table of Contents| here an example]].
 
* When approved to be Release Quality: Update the link to it on: the [[:Category:OWASP_Project | OWASP Project]] page and update its project quality tag on its project page to be Release Quality.
 
* When approved to be Release Quality: Update the link to it on: the [[:Category:OWASP_Project | OWASP Project]] page and update its project quality tag on its project page to be Release Quality.
 
  | style="width:20%; background:#e6e6e6" align="left"|
 
  | style="width:20%; background:#e6e6e6" align="left"|
Line 95: Line 96:
 
All Alpha Quality Requirements plus:
 
All Alpha Quality Requirements plus:
 
* The document seems sufficiently or substantially complete with respect to the topic or process it is intended to cover.
 
* The document seems sufficiently or substantially complete with respect to the topic or process it is intended to cover.
* All wiki content has been reviewed by a technical editor to ensure that English grammar is correct, understandable, and the content flows well accordingly to the [[OWASP Writing Style]].
+
* All wiki content has been reviewed by a technical editor to ensure that English grammar is correct, understandable, and the content flows well.
 
* Clear efforts to interlink this document to other appropriate Beta and Release Quality OWASP Documentation and Tools projects have been made.
 
* Clear efforts to interlink this document to other appropriate Beta and Release Quality OWASP Documentation and Tools projects have been made.
 
* When approved to be Beta Quality: Update the link to it on: the [[:Category:OWASP_Project | OWASP Project]] page and update its project quality tag on its project page to be Beta.
 
* When approved to be Beta Quality: Update the link to it on: the [[:Category:OWASP_Project | OWASP Project]] page and update its project quality tag on its project page to be Beta.

Revision as of 13:02, 29 April 2008

The following defines the quality levels for OWASP TOOLS and DOCUMENTATION (Projects). Rating projects against these criteria aid in recognizing excellent contributions and identifying projects in need of further work. All existing OWASP projects and their current ratings are here.

The Tool ratings are reasonably complete. The documentation rates still need to be developed.

Contents

Assessment Scale for OWASP TOOLS Projects

Class Criteria Review Process Example
Release Quality OWASP Tools

All Beta Quality Requirements plus:

  • Be reasonably easy to use
  • Include online documention built into tool (based on required user documentation)
  • Include build scripts that facilitate building the application from source (Goal: One-click build)
  • Publicly accessible bug tracking system established, ideally at the same place as the source code repository (e.g., at Google code, or Sourceforge)
  • Be run through Fortify Software's open source review (if appropriate) and FindBugs.
    • WebGoat would not be appropriate for example since it would light up like a Christmas tree :-)
  • C/C++ apps (if we have any) should consider being run through Coverity's open source review. Coverity also accepts submissions for open source Java applications.
  • When approved to be Release Quality: Update the link to it on: the OWASP Project page and update its project quality tag on its project page to be Release Quality.

Recommendations:

  • Conference style Powerpoint presentation that describes the use and status of the tool. (This could be used by others to discuss the tool at OWASP Chapter meetings, serve as easy to review offline documentation, etc.)
  • UAT pass on functionality of the tool
  • Developer documents any limitations
  • Requirement: 2 Reviewers + 1 OWASP Board Member.
    • If possible, the project's lead should suggest two Project Reviewers. One of them should be an OWASP Project Leader.
    • If the project's lead can't find the Project Reviewers, the OWASP Board will identify them. The same will happen whenever the reviewers suggested do not have the required approval.
OWASP WebGoat Project
Beta Quality OWASP Tools

All Alpha Quality Requirements plus:

  • Have an easy to use installer (Goal: Fully automated installer) (or stand alone executable version)
  • Include user documentation in Project's OWASP Wiki page(s)
  • Add a common About Box or help menu in the tool itself
    • (which lists name of tool, author, e-mail address of author, current version number and/or release date)
  • Include documentation on how to build it from code, starting with getting it directly from the code repository. (Ideally, this would include easy to use build scripts, which is required for Release Quality)
  • This documentation must stored be in the same repository as the code.
  • When approved to be Beta Quality: Update the link to it on: the OWASP Project page and update its project quality tag on its project page to be Beta.
  • Requirement: 2 Reviewers.
    • If possible, the project's lead should suggest two Project Reviewers. One of them should be an OWASP Project Leader.
    • If the project's lead can't find the Project Reviewers, the OWASP Board will identify them. The same will happen whenever the reviewers suggested do not have the required approval.
OWASP AntiSamy Project
Alpha Quality OWASP Tools
  • Agree to OWASP's open source license
  • The “main” page for any OWASP tool must be on the OWASP website. This page must:
    • describe the tool, the project leader, contact info, and include all relevant links, including a download link for the code and the executable version,
    • includes a roadmap/guideline pointing out the steps to achieve the purpose of project.
    • include the Alpha Quality Tool project tag. (Which we still need to define),
    • be placed at OWASP Project page.
  • Have its code and any documentation in Googlecode, or Sourceforge.
  • Mailing list for project created.
  • Solves a core application security need.
  • Requirement: 1 Reviewer.
    • If possible, the project's lead should suggest a Project Reviewer who is an existing OWASP Leader.
    • If the project's lead can't find a Project Reviewer, the OWASP Board will identify one. The same will happen whenever the reviewer suggested does not have the required approval.
OWASP CSRFTester Project

Assessment Scale for OWASP DOCUMENTATION Projects

Class Criteria Review Process Example
Release Quality OWASP Documentation

All Beta Quality Requirements plus:

  • Document has been reviewed accordingly to the OWASP Writing Style and updated to be consistent and not overly repetitive with all other Release Quality OWASP Documentation.
  • Conference style Powerpoint presentation that describes the use and status of the project. (This could be used by others to discuss the project at OWASP Chapter meetings, serve as easy to review offline documentation, etc.)
  • Wiki content, if more than 30 pages, has been converted to an OWASP Book and is available for download or purchase at the OWASP Lulu bookstore.
  • The referred above OWASP Book must have a table of contents that links all the wiki content together. See here an example.
  • When approved to be Release Quality: Update the link to it on: the OWASP Project page and update its project quality tag on its project page to be Release Quality.
  • Requirement: 2 Reviewers + 1 OWASP Board Member.
    • If possible, the project's lead should suggest two Project Reviewers. One of them should be an OWASP Project Leader.
    • If the project's lead can't find the Project Reviewers, the OWASP Board will identify them. The same will happen whenever the reviewers suggested do not have the required approval.
OWASP AppSec FAQ Project
Beta Quality OWASP Documentation

All Alpha Quality Requirements plus:

  • The document seems sufficiently or substantially complete with respect to the topic or process it is intended to cover.
  • All wiki content has been reviewed by a technical editor to ensure that English grammar is correct, understandable, and the content flows well.
  • Clear efforts to interlink this document to other appropriate Beta and Release Quality OWASP Documentation and Tools projects have been made.
  • When approved to be Beta Quality: Update the link to it on: the OWASP Project page and update its project quality tag on its project page to be Beta.
  • Requirement: 2 Reviewers.
    • If possible, the project's lead should suggest two Project Reviewers. One of them should be an OWASP Project Leader.
    • If the project's lead can't find the Project Reviewers, the OWASP Board will identify them. The same will happen whenever the reviewers suggested do not have the required approval.
OWASP CLASP Project
Alpha Quality OWASP Documentation
  • Agree to OWASP's open source license
  • The “main” page for any OWASP documentation project must be on the OWASP website. This page must:
    • describe the purpose and scope of project, the project leader, contact info, and include all relevant links,
    • includes a roadmap/guideline pointing out the steps to achieve the purpose of project.
    • includes a list of contributors, if a team effort.
    • include the Alpha Quality Tool project tag. (Which we still need to define),
    • be placed at OWASP Project page.
  • Have all its content stored in the OWASP wiki.
  • Mailing list for project created.
  • Solves a core application security documentation/process need.
  • Requirement: 1 Reviewer.
    • If possible, the project's lead should suggest a Project Reviewer who is an existing OWASP Leader.
    • If the project's lead can't find a Project Reviewer, the OWASP Board will identify one. The same will happen whenever the reviewer suggested does not have the required approval.
OWASP AJAX Security Project

FAQ

1. What is the purpose of the project ratings? 
The rating system allows OWASP to monitor the quality of Projects in our subject areas, and to prioritize work on these projects. It is also utilized to prepare for static releases of Wikipedia content.
2. How do I add a project (tool or documentation) to the OWASP Projects? 
To propose a new project, please send an email to OWASP.
3. How does the assessment scale work? 
Each category has a set of requirements/criteria to be met. Beta Quality implies that all of its requirements, as well as the Alpha Quality requirement have been met. Release Quality implies that all of the requirements, including Alpha and Beta, have been met.
4. Who can assess projects? 
The OWASP Project Manager can assign you a reviewer.
5. Why didn't the reviewer leave any comments? 
Unfortunately, due to the volume of projects that need to be assessed, we are unable to leave detailed comments in most cases. If you have particular questions, you might ask the person who assessed the project; they will be happy to provide you with their rationale.
6. What if I don't agree with a rating? 
You can list it in the section for assessment requests below, and someone will take a look at it. Alternatively, you can ask any member of the project to rate the project again.
7. Aren't the ratings subjective? 
Yes, they are somewhat subjective, but it's the best system we've been able to devise. If you have a better idea, please don't hesitate to let us know!
8. What if I have a question not listed here? 
If your question concerns the project assessment process specifically, please contact OWASP or its Project Manager directly.

Requests for assessment

If you have made significant changes to a project and would like an outside opinion on a new rating for it, please feel free to list it below and e-mail OWASP Project Manager.

  1. Here
  2. Or here
  3. Add new requests above this line