Uploaded image for project: 'ZooKeeper'
  1. ZooKeeper
  2. ZOOKEEPER-2090

Fix Zookeeper docs "To be done" notices

    Details

    • Type: Bug
    • Status: Open
    • Priority: Trivial
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: documentation
    • Labels:
    • Environment:

      Official website

      Description

      The docs on the website are full of TBDs since a long time ago. While there is not a full lack of docs, and you can get going with what there is, the main general-purpose entry points are not too polished and they give the impression ZK is not very well maintained to newcomers and anyone who just wants to see how ZK is progressing and refresh concepts.

      The ZK overview doc (http://zookeeper.apache.org/doc/trunk/zookeeperOver.html) is supposed to be a first entry point for new Zookeeper users and it is full of [tbd]s:

      When the session ends the znode is deleted. Ephemeral nodes are useful when you want to implement [tbd].

      And if the connection between the client and one of the Zoo Keeper servers is broken, the client will receive a local notification. These can be used to [tbd].

      Timeliness - The clients view of the system is guaranteed to be up-to-date within a certain time bound.

      For more information on these, and how they can be used, see [tbd]

      For a more in-depth discussion on these, and how they can be used to implement higher level operations, please refer to [tbd]

      Some distributed applications have used it to: [tbd: add uses from white paper and video presentation.] For more information, see [tbd]

      These znodes exists as long as the session that created the znode is active. When the session ends the znode is deleted. Ephemeral nodes are useful when you want to implement [tbd].

      The second entry point, "Getting Started" (http://zookeeper.apache.org/doc/trunk/zookeeperStarted.html)

      [tbd: what is the other config param?]

      Programmers guide (http://zookeeper.apache.org/doc/trunk/zookeeperProgrammers.html)

      "If the version it supplies doesn't match the actual version of the data, the update will fail. (This behavior can be overridden. For more information see... )[tbd...]"

      Connecting to ZooKeeper

      Read Operations

      Write Operations

      Handling Watches

      Miscelleaneous ZooKeeper Operations

      Program Structure, with Simple Example

      [tbd]

      ZooKeeper Whitepaper [tbd: find url]

      The definitive discussion of ZooKeeper design and performance, by Yahoo! Research
      API Reference [tbd: find url]

      The complete reference to the ZooKeeper API

      Administration guide (http://zookeeper.apache.org/doc/trunk/zookeeperAdmin.html)

      Provisioning

      Things to Consider: ZooKeeper Strengths and Limitations

      Administering

      TBD - tuning options for netty - currently there are none that are netty specific but we should add some. Esp around max bound on the number of reader worker threads netty creates.

      TBD - how to manage encryption

      TBD - how to manage certificates

      Since it is not a big deal to fix these, I think it is worth it to spend some hours doing it.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                Unassigned
                Reporter:
                hsanjuan Hector
              • Votes:
                1 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated:

                  Time Tracking

                  Estimated:
                  Original Estimate - 24h
                  24h
                  Remaining:
                  Remaining Estimate - 24h
                  24h
                  Logged:
                  Time Spent - Not Specified
                  Not Specified