Page Menu
Home
Software Heritage
Search
Configure Global Search
Log In
Files
F9697540
D4778.id16925.diff
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Award Token
Flag For Later
Size
1 KB
Subscribers
None
D4778.id16925.diff
View Options
diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -3,6 +3,12 @@
Search service for the Software Heritage archive.
+It is similar to swh-storage in what it contains,
+but provides different ways to query it: while swh-storage is mostly
+a key-value store that returns an object from a primary key,
+swh-search is focused on reverse indices, to allow finding objects that
+match some criteria; for example full-text search.
+
Currently uses ElasticSearch, and provides only origin search (by URL and metadata)
# Dependencies
diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,7 +1,15 @@
-Software Heritage - Python module template
-==========================================
+.. _swh-search:
-Python module template, used as skeleton to create new modules.
+Software Heritage - search service
+==================================
+
+The SWH search service, or swh-search, stores a partial copy of
+the |swh| archive.
+It is similar to swh-storage in what it contains,
+but provides different ways to query it: while swh-storage is mostly
+a key-value store that returns an object from a primary key,
+swh-search is focused on reverse indices, to allow finding objects that
+match some criteria; for example full-text search.
.. toctree::
@@ -9,9 +17,10 @@
:caption: Contents:
-Indices and tables
-==================
+Reference Documentation
+-----------------------
+
+.. toctree::
+ :maxdepth: 2
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+ /apidoc/swh.search
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Mon, Aug 18, 12:06 AM (2 w, 1 d ago)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
3221355
Attached To
D4778: Write some basic documentation to describe what swh-search is.
Event Timeline
Log In to Comment