Documentation

diff --git a/HOME.md b/HOME.md
index b8d1d9a8077efccc826735b8cbd55b63137b7835..6d19d0d2be1d0bf3cb5ba9469180281b9e8ae303 100644 (file)
--- a/HOME.md
+++ b/HOME.md
@@ -26,7 +26,8 @@ This documentation is the source content from which the [Gitblit website](http:/
 ### General Configuration & Administration\r
 \r
 [[src/site/setup_authentication.mkd]]\r
-[[src/site/setup_client.mkd]]\r
+[[src/site/setup_transport_http.mkd]]\r
+[[src/site/setup_transport_ssh.mkd]]\r
 [[src/site/setup_clientmenus.mkd]]\r
 [[src/site/eclipse_plugin.mkd]]\r
 [[src/site/setup_mirrors.mkd]]\r
@@ -46,6 +47,11 @@ This documentation is the source content from which the [Gitblit website](http:/
 [[src/site/tickets_setup.mkd]]\r
 [[src/site/tickets_replication.mkd]]\r
 \r
+### Gitblit Plugins\r
+\r
+[[src/site/plugins_overview.mkd]]\r
+[[src/site/plugins_extensions.mkd]]\r
+\r
 ### Other Pages\r
 \r
 [[src/site/federation.mkd]]\r

diff --git a/src/site/plugins_overview.mkd b/src/site/plugins_overview.mkd
index 45a5434487c53d910944b99a3f39c552762ac759..43f3a12ab9ec25018b54794b40d46c9d43b08e89 100644 (file)
--- a/src/site/plugins_overview.mkd
+++ b/src/site/plugins_overview.mkd
@@ -15,13 +15,13 @@ A plugin is a collection of Java classes and required jar dependencies bundled t
 
 The existing plugin mechanism is based on [pf4j](https://github.com/decebals/pf4j).  Plugins are distributed as zip files and may include their runtime dependencies or may rely on the bundled dependencies of other plugins and/or Gitblit core.
 
-The zip plugins are stored in `${baseFolder}/plugins` and are unpacked on startup into folders of the same name.
+The plugin zip files are stored in `${baseFolder}/plugins` and are unpacked on startup into folders of the same name.
 
 A plugin defines it's metadata in the META-INF/MANIFEST.MF file:
 
     Plugin-Id: powertools
     Plugin-Description: Command and control Gitblit over SSH
-    Plugin-Class: com.gitblit.plugin.powertools.Powertools
+    Plugin-Class: com.gitblit.plugin.powertools.Plugin
     Plugin-Version: 1.2.0
     Plugin-Requires: 1.5.0
     Plugin-Provider: gitblit.com
@@ -33,17 +33,17 @@ In addition to extending Gitblit core, plugins can also define extension points
 **NOTE:**
 The pf4j plugin framework relies on a javac apt processor to generate compile-time extension information, so be sure to enable apt processing in your build process.
 
-#### Limitations of Dependencies
+#### Limitations of Plugin Dependencies
 
-Plugins may specify dependencies by ID, but may not specify specific versions of a dependency.
+Plugins may specify plugin dependencies by their ID, but they may not specify dependency versions.
 
 ### Managing Plugins
 
 Administrators may manage plugins through the `plugin` SSH dispatch command:
 
-    ssh host plugin
+    ssh host -l username -p 29418 plugin
 
-Through this command interface plugins can be started, stopped, disabled, enabled, installed, uninstalled, listed, etc.
+Through this command interface plugins can be started, stopped, disabled, enabled, installed, uninstalled, listed, etc.  Each command is supports the `--help` argument which will guide you in understanding the options and usage of the command.
 
 ### Default Plugin Registry
 
@@ -55,11 +55,11 @@ The [registry](http://plugins.gitblit.com/plugins.json) is currently hosted in a
 
 ### Contributing Plugins to the Default Registry
 
-If you develop your own plugins that you want hosted by or linked in the default registry, open pull request for the registry repository.  Any contributed binaries hosted in this repository must have Maven metadata and the SHA-1 & MD5 checksums.  By default, Gitblit enforces checksum validation on all downloads.
+If you develop your own plugins that you want hosted by or linked in the default registry, open a pull request for the registry repository.  Any contributed binaries hosted in this repository must have Maven metadata and the SHA-1 & MD5 checksums.  By default, Gitblit enforces checksum validation on all downloads.
 
 ### Hosting your Own Registry / Allowing Multiple Registries
 
-The `plugins.json` file is parameterized with the `${self}` placeholder.  This parameter is substituted on download with with the source URL of the registry file.  This allows you to clone and serve your own copy of this git repository or just server your own `plugins.json` on your own network.
+The `plugins.json` file is parameterized with the `${self}` placeholder.  This parameter is substituted on download with with the source URL of the registry file.  This allows you to clone and serve your own copy of this git repository or just serve your own `plugins.json` on your own network.
 
 Gitblit also supports loading multiple plugin registries.  Just place another **properly formatted** `.json` file in `${baseFolder}/plugins` and Gitblit will load that as an additional registry.
 

diff --git a/src/site/tickets_setup.mkd b/src/site/tickets_setup.mkd
index c098f4c1799da645e7fcf6d489d2c6340d1bc08c..aeecbeb1df028968a9338a9b458142b1989145db 100644 (file)
--- a/src/site/tickets_setup.mkd
+++ b/src/site/tickets_setup.mkd
@@ -28,7 +28,7 @@ Your ticket journals are persisted to `id/{shard}/{id}/journal.json`.  These jou
 
 Your ticket journals are persisted to a Redis data store.  *Make sure you configure your Redis instance for durability!!*  This particular service is highly-scalable and very fast.  Plus you can use all of the power of Redis replication, should you want.
 
-The main drawback to this service is that Redis is primarily a Unix tool and works best on a Unix server.  While there is a Windows port, sort-of maintained by Microsoft, it is not actively updated.
+The main drawback to this service is that Redis is primarily a Unix tool and works best on a Unix server.  Microsoft is engaged with the Redis community and they do maintain a semi-active port of Redis for Windows servers.
 
     tickets.redis.url = redis://(:{password}@){hostname}:{port}(/{databaseId})