tor-browser

The Tor Browser
git clone https://git.dasho.dev/tor-browser.git
Log | Files | Refs | README | LICENSE

index.rst (1516B)


      1 Places
      2 ======
      3 
      4 This document describes the implementation of the Firefox Places component.
      5 
      6 It is a robust system to manage History and Bookmarks through a database on the backend side and a model-view-controller system that connects frontend UI user manipulation.
      7 
      8 History and Bookmarks
      9 ---------------------
     10 
     11 In Firefox 2, History and Bookmarks used to be kept into separate databases in the Resource Description Framework format (`RDF format`_).
     12 
     13 However, Firefox 3 implemented the Places system. It has been done due to multiple reasons, such as:
     14 
     15  * **Performance**: certain search or maintenance operations were very slow
     16  * **Reliability**: the filesystem facing side of RDF was not so robust, often causing corruption or unexpected states
     17  * **Flexibility**: being able to cross data allows for interesting features, like the Awesome Bar
     18  * **Maintainability**: the future of RDF was unclear, while SQLite is actively maintained and used by a large number of applications
     19 
     20  .. _RDF format: https://en.wikipedia.org/wiki/Resource_Description_Framework
     21 
     22 Where to Start
     23 --------------
     24 
     25 For the high-level, non-technical summary of how History and Bookmarks works, read :doc:`nontechnical-overview`.
     26 For more specific, technical details of implementation, read :doc:`architecture-overview`.
     27 
     28 Governance
     29 ----------
     30 
     31 See `Bookmarks & History (Places) </mots/index.html#bookmarks-history>`__
     32 
     33 Table of Contents
     34 -----------------
     35 
     36 .. toctree::
     37   :maxdepth: 2
     38 
     39   nontechnical-overview
     40   architecture-overview