[Debtags-commits] [svn] r1391 - in debtags/trunk: . doc

Enrico Zini enrico at costa.debian.org
Sat Oct 15 13:09:53 UTC 2005 

Author: enrico
Date: Sat Oct 15 13:09:51 2005
New Revision: 1391

Modified:
   debtags/trunk/   (props changed)
   debtags/trunk/README
   debtags/trunk/doc/faq.rst
Log:
 r5540 at viaza:  enrico | 2005-10-15 15:09:42 +0200
 README updates
 Improved FAQ (Thanks Lunar!)


Modified: debtags/trunk/README
==============================================================================
--- debtags/trunk/README	(original)
+++ debtags/trunk/README	Sat Oct 15 13:09:51 2005
@@ -138,6 +138,17 @@
 
 These are the TODO-list items currently being worked on::
 
+ - Smart querying:
+    1. full text search
+    2. get the n (=3?) most recurrent tags (possibly multiplying their
+       cardinality in the result by the tag score, to add a user-defined
+       weighting)
+    3. Add all the items whose tagset contains the n most recurrent tags
+    4. Allow to AND or AND NOT for tags, possibly allowing the user to choose
+       among the most recurrent tags
+   Resulting query:
+    ((Full text UNION "similar" items) UNION and items) INTERSECTION and not items
+
  - Allow to have ~/.debtags/vocabulary merged in
  
  - Try to get rid of the Singleton Environment

Modified: debtags/trunk/doc/faq.rst
==============================================================================
--- debtags/trunk/doc/faq.rst	(original)
+++ debtags/trunk/doc/faq.rst	Sat Oct 15 13:09:51 2005
@@ -2,10 +2,14 @@
 Debtags Frequently Asked Questions
 ==================================
 
+-------
+General
+-------
+
 How many people are working on or around Debtags now?
 -----------------------------------------------------
 
-There's about 5 active people, but everyone active on something different:
+There's about 6 active people, but everyone active on something different:
 
  * Enrico Zini is working at the Debtags libraries and tools
  * Erich Schubert is working at the `packagebrowser and central tag repository`__
@@ -13,6 +17,7 @@
    also working at `packagesearch`_, which uses debtags, among other data, to
    search for packages
  * Thaddeus H. Black is working at debram_, with the intention of converging to debtags
+ * Justin B. Rye is active on the vocabulary.
  * Emanuele Rocca maintains the bash completion scripts for debtags 
  
 Plus, there are various occasional contributors adding tags, either with
@@ -34,6 +39,9 @@
 Peter Rockai is the main developer of `libapt-front`_, together with Michael
 Vogt and Enrico Zini.
 
+Peter Rockai's `adept`_ is a recently developed KDE package manager which has
+been built with debtags support right from the start.
+
 
 Aren't debram and debtags duplicating the same effort?
 ------------------------------------------------------
@@ -61,6 +69,7 @@
 up-to-date tag source (and to our knowledge, also the only one) that is
 available for the main tag collection.
 
+
 Is there a debtags mailinglist?
 -------------------------------
 
@@ -125,6 +134,10 @@
 more informations, see the notes on the `theorical foundation`_ of debtags.
 
 
+---------------------
+Integration in Debian
+---------------------
+
 When is Debtags going to be integrated into apt or aptitude or ...?
 -------------------------------------------------------------------
 
@@ -146,20 +159,76 @@
 use packagebrowser_ or `debtags-edit`_.
 
 
+When does a new package get tagged?
+------------------------------------
+
+Everyone can tag new packages using the packagebrowser_ or `debtags-edit`_, but
+you can see the new data in apt-cache only after Enrico manually reviews them.
+
+Reviewing the tags is quite a time-consuming task and could use a hand.  More
+people could contribute: it's it's just a matter of committing the good tags
+into the database in the subversion repository, and of removing the bad tags
+from the main database.  There's a couple of scripts that can help in the
+process.  If you have time and want to help, please drop a message in the
+`debtags-devel mailing list`_; the only requirement for this work is to have a
+good knowledge of the tag vocabulary and staying up to date with its evolution.
+
+
+When are the tags going to move in the control file?
+----------------------------------------------------
+
+Good tags are copied in the Packages file by means of an "override" file, which
+is a file that adds or overrides a field from the control file written by the
+package maintainers.
+
+Tags are added to the override file after manual review.  Think of the tags in
+the override file as the "stable" tags and the ones in the debtags database as
+the "unstable" tags.
+
+Allowing the maintainers to specify tags in the control file could be
+difficult for many reasons:
+
+ * Some tags are more easily added by people who are not the DD.  The
+   maintainer can add ``made-of::*`` and ``interface::*``, but some other
+   person could add ``works-with::*`` and ``accessibility::*``.
+ * Sometimes we do a reorganization (for example, moving ``protocol::icq`` to
+   ``protocol::im:icq``) and we can't ask all maintainers to handle those
+   changes, and these reorganisations tend to happen quite often.
+
+
+Is there any plan to drop "Section:" ?
+-------------------------------------------
+
+I don't think they'll be dropped, as they're serving a different purpose at the
+moment (that is, splitting the archive somehow).  In my view, they should be
+ignored by package managers, using debtags instead.
+
+
+-----------
+Development
+-----------
+
 How can I experiment writing applications using debtags?
 --------------------------------------------------------
 
-You can have a look at `libdebtags1-dev`_, which also has python__ and perl__
-bindings: Enrico Zini is trying to make it easy for developers to access
-debtags functions and experiment with building tools and interfaces on top of
-them.
-
-.. __: http://packages.debian.org/python-debtags
-.. __: http://packages.debian.org/libdebtags-perl
+You can have a look at `libapt-front-dev`_, which allows access to both debtags
+and apt package data and is a really good C++ library.  Thanks to the work of
+Torsten Marek, it may soon have Python bindings.
+
+..
+ , which also has python__ and perl__
+ bindings: Enrico Zini is trying to make it easy for developers to access
+ debtags functions and experiment with building tools and interfaces on top of
+ them.
+
+..
+  .. __: http://packages.debian.org/python-debtags
+  .. __: http://packages.debian.org/libdebtags-perl
 
 And of course don't forget to subscribe to the `debtags-devel mailing list`_,
 where you can ask for help at will.
 
+
 How can I help?
 ---------------
 
@@ -194,11 +263,13 @@
    has big potential in so many fields!
 
 
+.. _adept: http://web.ekhis.org/adept.html
 .. _debram: http://packages.debian.org/unstable/admin/debram
 .. _debtags-devel mailing list: http://lists.alioth.debian.org/mailman/listinfo/debtags-devel
 .. _debtags-edit: http://packages.debian.org/unstable/misc/debtags-edit
 .. _libapt-front: http://libapt-front.alioth.debian.org/
 .. _libdebtags1-dev: http://packages.debian.org/libdebtags1-dev
+.. _libapt-front-dev: http://packages.debian.org/libapt-front-dev
 .. _packagebrowser: http://debian.vitavonni.de/packagebrowser/
 .. _packagesearch: http://packagesearch.sourceforge.net/
 .. _theorical foundation: http://debtags.alioth.debian.org/faceted.html

More information about the Debtags-commits mailing list