Permalink
Browse files

Merge branch 'master' of https://github.com/ideabrian/packaginator in…

…to ideabrian-master
  • Loading branch information...
pydanny committed Mar 16, 2011
2 parents 62b5c4f + 1a8b32e commit 8d2ec71a71fa8cdb9c3fcc06266b2925c670ee8d
Showing with 13 additions and 11 deletions.
  1. +13 −11 docs/introduction.rst
View
@@ -2,34 +2,36 @@
Introduction
=============
-Packaginator solves the problem in the Python community of being able to easily identify good apps, frameworks, and packages. Ever want to know which is the most popular or well supported Python httplib replacement, web framework, or api tool? Packaginator solves that problem for you!
+Ever want to know which is the most popular or well supported Python httplib replacement, web framework, or api tool? Packaginator solves that problem for you!
-It does this by storing information on packages fetched from public APIs provided by PyPI, Github, BitBucket, Launchpad, and SourceForge, and then provides extremely useful comparison tools for them.
+Easily identify good apps, frameworks, and packages.
+
+Packaginator stores information on fetched packages and provides easy comparison tools for them. Public APIs include PyPI, Github, BitBucket, Launchpad, and SourceForge.
The Site
--------
-The most current example is live and functional at http://www.djangopackages.com.
+A current example is live: http://www.djangopackages.com
Grids!
~~~~~~
-Grids let you compare packages to each other. A grid comes with a number of default items compared, but you can add more features in order to get a more specific comparison.
+Grids let you compare packages. A grid comes with default comparison items and you can add features to get a more specific.
-We think grids are a gigantic improvement over the traditional tagging system, because we think that grids give us a lot more specificity.
+We think comparison grids are an improvement over traditional tagging system because specificity helps make informed decisions.
Categories of Packages
~~~~~~~~~~~~~~~~~~~~~~
The fixtures provide four categories: apps, frameworks, projects, and utilities.
Google Project Hosting and Sourceforge are not fully supported!
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Not yet.
+Not yet.
-The progenitor of Packaginator, Django Packages was cooked up during Django Dash 2010. We wanted to keep the scope of our work reasonable. We'll try and include those sites in the future. We also want to include other package repo systems over time. As for what we support:
+The progenitor of Packaginator, Django Packages was cooked up during Django Dash 2010. We wanted to keep the scope of our work reasonable. We'll try to include more sites in the future. Here's what we support:
- * Packaginator does support Github and Bitbucket and Launchpad.
- * Sourceforge needs some tweaking but is otherwise it is done.
- * Google Project Hosting may not happen because of a lack of a formal API and not much desire to screen scrape their arcane browser interface.
+ * Github, Bitbucket and Launchpad.
+ * Sourceforge needs tweaking.
+ * NOT YET: Google Project Hosting. Google's lack of a formal API leaves us the option of screen-scraping their content. We're not excited about that.

0 comments on commit 8d2ec71

Please sign in to comment.