Update new site to include remaining gerritcodereview.com pages.
Changes include:
* Moved the about page out of gitiles and into the Jekyll site. Update the
navigation (top and sidebar) to include new file. Retitle file "Gerrit's
History."
* Moved issues page into Jekyll. Update top navigation. (this file is not
needed in the left nav)
* Moved releases folder
* Moved "docs" folder. (Is this folder still necessary?)
* Deleted:
* foo.md (test file)
* googlebdbd1417c92a607.html (an attempt to show ownership of site)
* Gemfile (not needed because Docker)
* Gemfile.lock (not needed because Docker)
* images directory (copied into jekyll-source folder earlier)
* index.md (outdated)
* navbar.md (obsolete)
* firebase-debug.log (unintentionally added)
Change-Id: I6829109ebfef05183a614c0b5621fcab2b5b9fa1
diff --git a/Gemfile b/Gemfile
deleted file mode 100755
index 37f5eaa..0000000
--- a/Gemfile
+++ /dev/null
@@ -1,2 +0,0 @@
-source 'https://rubygems.org'
-gem 'github-pages', group: :jekyll_plugins
diff --git a/Gemfile.lock b/Gemfile.lock
deleted file mode 100644
index 752d14e..0000000
--- a/Gemfile.lock
+++ /dev/null
@@ -1,218 +0,0 @@
-GEM
- remote: https://rubygems.org/
- specs:
- activesupport (4.2.9)
- i18n (~> 0.7)
- minitest (~> 5.1)
- thread_safe (~> 0.3, >= 0.3.4)
- tzinfo (~> 1.1)
- addressable (2.5.2)
- public_suffix (>= 2.0.2, < 4.0)
- coffee-script (2.4.1)
- coffee-script-source
- execjs
- coffee-script-source (1.11.1)
- colorator (1.1.0)
- ethon (0.10.1)
- ffi (>= 1.3.0)
- execjs (2.7.0)
- faraday (0.13.1)
- multipart-post (>= 1.2, < 3)
- ffi (1.9.18)
- forwardable-extended (2.6.0)
- gemoji (3.0.0)
- github-pages (162)
- activesupport (= 4.2.9)
- github-pages-health-check (= 1.3.5)
- jekyll (= 3.5.2)
- jekyll-avatar (= 0.5.0)
- jekyll-coffeescript (= 1.0.2)
- jekyll-default-layout (= 0.1.4)
- jekyll-feed (= 0.9.2)
- jekyll-gist (= 1.4.1)
- jekyll-github-metadata (= 2.9.3)
- jekyll-mentions (= 1.2.0)
- jekyll-optional-front-matter (= 0.2.0)
- jekyll-paginate (= 1.1.0)
- jekyll-readme-index (= 0.1.0)
- jekyll-redirect-from (= 0.12.1)
- jekyll-relative-links (= 0.4.1)
- jekyll-sass-converter (= 1.5.0)
- jekyll-seo-tag (= 2.3.0)
- jekyll-sitemap (= 1.1.1)
- jekyll-swiss (= 0.4.0)
- jekyll-theme-architect (= 0.1.0)
- jekyll-theme-cayman (= 0.1.0)
- jekyll-theme-dinky (= 0.1.0)
- jekyll-theme-hacker (= 0.1.0)
- jekyll-theme-leap-day (= 0.1.0)
- jekyll-theme-merlot (= 0.1.0)
- jekyll-theme-midnight (= 0.1.0)
- jekyll-theme-minimal (= 0.1.0)
- jekyll-theme-modernist (= 0.1.0)
- jekyll-theme-primer (= 0.5.2)
- jekyll-theme-slate (= 0.1.0)
- jekyll-theme-tactile (= 0.1.0)
- jekyll-theme-time-machine (= 0.1.0)
- jekyll-titles-from-headings (= 0.4.0)
- jemoji (= 0.8.1)
- kramdown (= 1.13.2)
- liquid (= 4.0.0)
- listen (= 3.0.6)
- mercenary (~> 0.3)
- minima (= 2.1.1)
- rouge (= 1.11.1)
- terminal-table (~> 1.4)
- github-pages-health-check (1.3.5)
- addressable (~> 2.3)
- net-dns (~> 0.8)
- octokit (~> 4.0)
- public_suffix (~> 2.0)
- typhoeus (~> 0.7)
- html-pipeline (2.7.1)
- activesupport (>= 2)
- nokogiri (>= 1.4)
- i18n (0.8.6)
- jekyll (3.5.2)
- addressable (~> 2.4)
- colorator (~> 1.0)
- jekyll-sass-converter (~> 1.0)
- jekyll-watch (~> 1.1)
- kramdown (~> 1.3)
- liquid (~> 4.0)
- mercenary (~> 0.3.3)
- pathutil (~> 0.9)
- rouge (~> 1.7)
- safe_yaml (~> 1.0)
- jekyll-avatar (0.5.0)
- jekyll (~> 3.0)
- jekyll-coffeescript (1.0.2)
- coffee-script (~> 2.2)
- coffee-script-source (~> 1.11.1)
- jekyll-default-layout (0.1.4)
- jekyll (~> 3.0)
- jekyll-feed (0.9.2)
- jekyll (~> 3.3)
- jekyll-gist (1.4.1)
- octokit (~> 4.2)
- jekyll-github-metadata (2.9.3)
- jekyll (~> 3.1)
- octokit (~> 4.0, != 4.4.0)
- jekyll-mentions (1.2.0)
- activesupport (~> 4.0)
- html-pipeline (~> 2.3)
- jekyll (~> 3.0)
- jekyll-optional-front-matter (0.2.0)
- jekyll (~> 3.0)
- jekyll-paginate (1.1.0)
- jekyll-readme-index (0.1.0)
- jekyll (~> 3.0)
- jekyll-redirect-from (0.12.1)
- jekyll (~> 3.3)
- jekyll-relative-links (0.4.1)
- jekyll (~> 3.3)
- jekyll-sass-converter (1.5.0)
- sass (~> 3.4)
- jekyll-seo-tag (2.3.0)
- jekyll (~> 3.3)
- jekyll-sitemap (1.1.1)
- jekyll (~> 3.3)
- jekyll-swiss (0.4.0)
- jekyll-theme-architect (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-cayman (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-dinky (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-hacker (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-leap-day (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-merlot (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-midnight (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-minimal (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-modernist (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-primer (0.5.2)
- jekyll (~> 3.5)
- jekyll-github-metadata (~> 2.9)
- jekyll-seo-tag (~> 2.2)
- jekyll-theme-slate (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-tactile (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-theme-time-machine (0.1.0)
- jekyll (~> 3.5)
- jekyll-seo-tag (~> 2.0)
- jekyll-titles-from-headings (0.4.0)
- jekyll (~> 3.3)
- jekyll-watch (1.5.0)
- listen (~> 3.0, < 3.1)
- jemoji (0.8.1)
- activesupport (~> 4.0, >= 4.2.9)
- gemoji (~> 3.0)
- html-pipeline (~> 2.2)
- jekyll (>= 3.0)
- kramdown (1.13.2)
- liquid (4.0.0)
- listen (3.0.6)
- rb-fsevent (>= 0.9.3)
- rb-inotify (>= 0.9.7)
- mercenary (0.3.6)
- mini_portile2 (2.3.0)
- minima (2.1.1)
- jekyll (~> 3.3)
- minitest (5.10.3)
- multipart-post (2.0.0)
- net-dns (0.8.0)
- nokogiri (1.8.1)
- mini_portile2 (~> 2.3.0)
- octokit (4.7.0)
- sawyer (~> 0.8.0, >= 0.5.3)
- pathutil (0.14.0)
- forwardable-extended (~> 2.6)
- public_suffix (2.0.5)
- rb-fsevent (0.10.2)
- rb-inotify (0.9.10)
- ffi (>= 0.5.0, < 2)
- rouge (1.11.1)
- safe_yaml (1.0.4)
- sass (3.5.1)
- sass-listen (~> 4.0.0)
- sass-listen (4.0.0)
- rb-fsevent (~> 0.9, >= 0.9.4)
- rb-inotify (~> 0.9, >= 0.9.7)
- sawyer (0.8.1)
- addressable (>= 2.3.5, < 2.6)
- faraday (~> 0.8, < 1.0)
- terminal-table (1.8.0)
- unicode-display_width (~> 1.1, >= 1.1.1)
- thread_safe (0.3.6)
- typhoeus (0.8.0)
- ethon (>= 0.8.0)
- tzinfo (1.2.3)
- thread_safe (~> 0.1)
- unicode-display_width (1.3.0)
-
-PLATFORMS
- ruby
-
-DEPENDENCIES
- github-pages
-
-BUNDLED WITH
- 1.15.4
diff --git a/foo.md b/foo.md
deleted file mode 100644
index e7001aa..0000000
--- a/foo.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Hello world
-
-This is a test.
diff --git a/googlebdbd14417c92a607.html b/googlebdbd14417c92a607.html
deleted file mode 100755
index af9afeb..0000000
--- a/googlebdbd14417c92a607.html
+++ /dev/null
@@ -1 +0,0 @@
-google-site-verification: googlebdbd14417c92a607.html
\ No newline at end of file
diff --git a/images/access.png b/images/access.png
deleted file mode 100644
index cd93b2d..0000000
--- a/images/access.png
+++ /dev/null
Binary files differ
diff --git a/images/branches.png b/images/branches.png
deleted file mode 100644
index e6778ac..0000000
--- a/images/branches.png
+++ /dev/null
Binary files differ
diff --git a/images/diffy100.png b/images/diffy100.png
deleted file mode 100644
index 6129963..0000000
--- a/images/diffy100.png
+++ /dev/null
Binary files differ
diff --git a/images/diffy200.png b/images/diffy200.png
deleted file mode 100644
index 7d709dd..0000000
--- a/images/diffy200.png
+++ /dev/null
Binary files differ
diff --git a/images/diffy45.png b/images/diffy45.png
deleted file mode 100644
index cfe2101..0000000
--- a/images/diffy45.png
+++ /dev/null
Binary files differ
diff --git a/images/project-list.png b/images/project-list.png
deleted file mode 100644
index 7853d27..0000000
--- a/images/project-list.png
+++ /dev/null
Binary files differ
diff --git a/images/sbs.png b/images/sbs.png
deleted file mode 100644
index 7d97332..0000000
--- a/images/sbs.png
+++ /dev/null
Binary files differ
diff --git a/index.md b/index.md
deleted file mode 100644
index 023b1b9..0000000
--- a/index.md
+++ /dev/null
@@ -1,97 +0,0 @@
-## Code Review for Git
-
-Gerrit provides web based code review and repository management for
-the [Git][git] version control system.
-
-[git]: http://git-scm.com/
-
-|||---||| 2,2,2,3,:1,2
-
-
-### Discuss code
-
-and boost your team's code fu by talking about specifics.
-
-### Serve Git
-
-as an integrated experience within the larger code review flow.
-
-### Manage workflows
-
-with deeply integrated and delegatable access controls.
-
-*** promo
-
-## Download
-
-[Gerrit 2.14.3][download]
-
-***
-
-|||---|||
-
-## Discuss code
-
-Read old and new versions of files with syntax highlighting and
-colored differences. Discuss specific sections with others to make
-the right changes.
-
-
-
-## Manage and serve Git repositories
-
-Gerrit includes Git-enabled SSH and HTTPS servers compatible with all
-Git clients. Simplify management by hosting many Git repositories
-together.
-
-|||---||| 6,2,4
-
-#### Navigate projects
-
-
-
-#### Control access
-
-
-
-#### Update branches
-
-
-|||---|||
-
-Schedule [git gc] over all managed repositories and [replicate] to
-geographical mirrors for latency reduction and backup servers for hot
-spare redundancy.
-
-## Extensible through plugins
-
-Gerrit Code Review can be extended and further customized by installing
-[server-side plugins][plugins]. Source code for additional plugins
-can be found through the [project listing](https://gerrit.googlesource.com/plugins/).
-
-## Get in touch
-
-|||---||| 2,2,2,:4,2
-
-### Mailing list
-
-[repo-discuss](https://groups.google.com/group/repo-discuss)
-
-### Social media
-
-[](https://plus.google.com/communities/111271594706618791655)
-
-[](https://twitter.com/gerritreview)
-
-### IRC
-
-[freenode](https://freenode.net/) #gerrit
-
-[Channel log](http://echelog.com/logs/browse/gerrit/)
-
-|||---|||
-
-[download]: /releases/2.14.md
-[git gc]: https://gerrit-documentation.storage.googleapis.com/Documentation/2.14.3/config-gerrit.html#gc
-[plugins]: https://gerrit-documentation.storage.googleapis.com/Documentation/2.14.3/config-plugins.html
-[replicate]: https://gerrit.googlesource.com/plugins/replication/+doc/master/src/main/resources/Documentation/config.md
diff --git a/jekyll-source/.gitignore b/jekyll-source/.gitignore
index 67cb5ca..f4f7421 100644
--- a/jekyll-source/.gitignore
+++ b/jekyll-source/.gitignore
@@ -1,6 +1,8 @@
_site/
+firebase-debug.log
.sass-cache/
.jekyll-metadata
_pdf
.DS_Store
.idea
+vendor/
diff --git a/jekyll-source/_data/sidebars/gerritdoc_sidebar.yml b/jekyll-source/_data/sidebars/gerritdoc_sidebar.yml
index 2a64824..e79d344 100644
--- a/jekyll-source/_data/sidebars/gerritdoc_sidebar.yml
+++ b/jekyll-source/_data/sidebars/gerritdoc_sidebar.yml
@@ -42,6 +42,10 @@
url: /intro-gerrit-walkthrough.html
output: web
+ - title: Gerrit's History
+ url: /about.html
+ output: web
+
- title: "Tutorials"
output: web
folderitems:
diff --git a/jekyll-source/_data/topnav.yml b/jekyll-source/_data/topnav.yml
index 6c9fb35..f4ecb0a 100644
--- a/jekyll-source/_data/topnav.yml
+++ b/jekyll-source/_data/topnav.yml
@@ -4,7 +4,9 @@
- title: Topnav
items:
- title: About
- external_url: https://www.gerritcodereview.com/about.md
+ url: /about.html
+ - title: Issues
+ url: /issues.html
#Topnav dropdowns
topnav_dropdowns:
- title: Topnav dropdowns
diff --git a/firebase.json b/jekyll-source/firebase.json
similarity index 100%
rename from firebase.json
rename to jekyll-source/firebase.json
diff --git a/about.md b/jekyll-source/pages/site/about.md
similarity index 96%
rename from about.md
rename to jekyll-source/pages/site/about.md
index c7ce2fb..e3ff6c9 100644
--- a/about.md
+++ b/jekyll-source/pages/site/about.md
@@ -1,4 +1,8 @@
-# Origin Story
+---
+title: "Gerrit's History"
+sidebar: gerritdoc_sidebar
+permalink: about.html
+---
## Google Mondrian
diff --git a/docs/MultiMaster.md b/jekyll-source/pages/site/docs/MultiMaster.md
similarity index 91%
rename from docs/MultiMaster.md
rename to jekyll-source/pages/site/docs/MultiMaster.md
index 239d0e3..2354d71 100644
--- a/docs/MultiMaster.md
+++ b/jekyll-source/pages/site/docs/MultiMaster.md
@@ -1,10 +1,16 @@
+---
+title: "MultiMaster"
+permalink: multimaster.html
+---
+
+
We spent some time at the May 2012 Hackathon outlining an incremental approach
to making open source Gerrit clusterable (the version running for android-review
and gerrit-review is already clustered but uses much of Google's proprietary
technologies such as GFS and BigTable). Several incremental steps were outlined
on how to move Gerrit in that direction.
-# Shared Git Repo - Shared DB
+## Shared Git Repo - Shared DB
This is the simplest case for Gerrit multi master, so it is likely the first
step which is needed by most other ideas is to support a very simple
@@ -26,9 +32,9 @@
eviction (a plugin is up for [review]
(https://gerrit-review.googlesource.com/#/c/37460/1) which does this using UDP).
-# 2 could be easily solved by manually determining a submit master and later
+## 2 could be easily solved by manually determining a submit master and later
-upgrading to some sort of voting mechanism among peer masters to choose a submit
+Upgrading to some sort of voting mechanism among peer masters to choose a submit
master, these would be incremental approaches. The issue is that each server
runs a plugin queue and can therefor can attempt to merge changes to the same
branches at the same time resulting in "failed to lock" errors which will leave
@@ -37,7 +43,7 @@
peer goes down, might its queue be the only holder of certain changes which then
will be missed until a restart of some server?
-# 3 can be solved similarly to #2
+## 3 can be solved similarly to #2
Select a replication master. The replication master is responsible to rerun full
replication on startup and anytime a master goes down (since it may have currently
@@ -62,7 +68,7 @@
(https://groups.google.com/d/msg/repo-discuss/ZIIuBaCz9Jc/ZTQGpuy_Y1MJ) about
some what is required for this setup to work well.
-# Multi Site Masters with Separate Backends
+## Multi Site Masters with Separate Backends
The main additional problem with separate backends is: resolving ref updates in
a globally safe way. In Google’s implementation, this is solved by placing the
@@ -74,7 +80,7 @@
A plugin for ZooKeeper ref-db is up for [review]
(https://gerrit-review.googlesource.com/#/c/37460/1).
-# Distributed FS
+## Distributed FS
Finally, it was felt that once multi sites were conquered, that a distributed
filesystem may eventually be needed to scale the git repos effectively, Hadoop
diff --git a/docs/Notedb.md b/jekyll-source/pages/site/docs/Notedb.md
similarity index 98%
rename from docs/Notedb.md
rename to jekyll-source/pages/site/docs/Notedb.md
index 493d74d..34d4b4d 100644
--- a/docs/Notedb.md
+++ b/jekyll-source/pages/site/docs/Notedb.md
@@ -1,4 +1,10 @@
-### What is notedb?
+---
+title: "Notedb"
+permalink: notedb.html
+---
+
+
+## What is notedb?
Notedb is the successor to ReviewDb: a replacement database backend for Gerrit.
The goal is to read code review metadata from the same set of repositories that
diff --git a/docs/OutstandingTopics.md b/jekyll-source/pages/site/docs/OutstandingTopics.md
similarity index 97%
rename from docs/OutstandingTopics.md
rename to jekyll-source/pages/site/docs/OutstandingTopics.md
index 215cfee..f28cdd2 100644
--- a/docs/OutstandingTopics.md
+++ b/jekyll-source/pages/site/docs/OutstandingTopics.md
@@ -1,4 +1,7 @@
-# Overview
+---
+title: "Outstanding Topics"
+permalink: outstandingtopics.html
+---
Following a [discussion on the mailing list]
(https://groups.google.com/forum/#!topic/repo-discuss/qKz7AtZDlC4) we decided to
diff --git a/docs/ReviewKungFu.md b/jekyll-source/pages/site/docs/ReviewKungFu.md
similarity index 94%
rename from docs/ReviewKungFu.md
rename to jekyll-source/pages/site/docs/ReviewKungFu.md
index b080ee4..4b57359 100644
--- a/docs/ReviewKungFu.md
+++ b/jekyll-source/pages/site/docs/ReviewKungFu.md
@@ -1,4 +1,9 @@
-# Review Kung Fu
+---
+title: "Review Kung Fu"
+permalink: ReviewKungFu.html
+---
+
+## Review Kung Fu
As you progress on your path of Review Kung Fu your skill may take you to new
levels. Your objective is to spot potential problems and help others find
@@ -16,7 +21,7 @@
your arrogance, but because Diffy wants those seeking to improve their Kung Fu
to easily recognize those whose skill may help them deliver.
-# Diffy's Badges
+## Diffy's Badges
### Toes
diff --git a/docs/RoadMap.md b/jekyll-source/pages/site/docs/RoadMap.md
similarity index 96%
rename from docs/RoadMap.md
rename to jekyll-source/pages/site/docs/RoadMap.md
index 0998c25..86cfbfc 100644
--- a/docs/RoadMap.md
+++ b/jekyll-source/pages/site/docs/RoadMap.md
@@ -1,4 +1,9 @@
-# Introduction
+---
+title: "RoadMap"
+permalink: roadmap.html
+---
+
+## Introduction
There are many ideas suggested, and discussions which lead to decisions about
the future direction and designs of Gerrit which happen in many forums: on IRC,
@@ -13,7 +18,7 @@
coming down the pike. So we will attempt to illustrate some of these decisions
here.
-# Architecture
+## Architecture
* The REST API is viewed as the longterm stable approach for RPCs with the
Gerrit Server. At this point new UI elements and new ssh commands should be
diff --git a/docs/Scaling.md b/jekyll-source/pages/site/docs/Scaling.md
similarity index 96%
rename from docs/Scaling.md
rename to jekyll-source/pages/site/docs/Scaling.md
index 596c64b..d048d41 100644
--- a/docs/Scaling.md
+++ b/jekyll-source/pages/site/docs/Scaling.md
@@ -1,4 +1,9 @@
-# Scaling Dimensions
+---
+title: "Scaling Dimensions"
+permalink: scaling.html
+---
+
+## Scaling Dimensions
As you scale, you will always run into some issues. Depending on your specific
setup those issues may be very different from what other people are running
@@ -28,9 +33,9 @@
--------------------------------------------------------------------------------
-# Servers
+## Servers
-## Master
+### Master
The first step to scaling is to scale your master server. Some easy, but pricey
ways to scale your master are:
@@ -42,7 +47,7 @@
repos are not well repacked (seeks can be crippling here).
* Network, I suspect that most large installs use 10Gb Ethernet
-## Mirrors/Slaves
+### Mirrors/Slaves
Once you have a decent master, it is probably worth adding either some git
mirrors (if you do not need ACLs on your repos), or Gerrit slaves to help
@@ -51,7 +56,7 @@
particularly useful for remote sites. Some of the larger installations have at
least 25 of these.
-### Shared Storage and Replication Entries For Slaves
+#### Shared Storage and Replication Entries For Slaves
A common practice is to use site local shared storage (NFS...) on remote slaves
when there is more than one slave at the remote site. One major advantage of
@@ -65,7 +70,7 @@
to a different slave (since the back-end storage is the same, they all will
still see every update).
-### DB Slaves
+#### DB Slaves
DB slaves are being used on remote sites so that remote slaves do not have to
traverse the WAN to talk to the master DB. Both PostGreSQL and MYSQL are being
@@ -74,7 +79,7 @@
(https://gerrit-review.googlesource.com/#/c/35220) was also designed to help
with this.)
-## Multi - Master
+### Multi - Master
The Gerrit MultiMaster plug-in describes how to setup a single site multi-master
with a shared storage back-end for git repository data. However, there are
@@ -84,7 +89,7 @@
--------------------------------------------------------------------------------
-# Jetty
+## Jetty
The default built in web container which Gerrit uses is Jetty. Some
installations have had serious "Failed to dispatch" errors which lead to 100%CPU
@@ -97,7 +102,7 @@
--------------------------------------------------------------------------------
-# Repo Syncs
+## Repo Syncs
With beefier servers, many people have [seen]
(http://groups.google.com/group/repo-discuss/browse_thread/thread/c8f003f2247d7157/ad6915f5558df8f5?lnk=gst&q=repo+sync+error#ad6915f5558df8f5)
@@ -112,7 +117,7 @@
--------------------------------------------------------------------------------
-# Java HEAP and GC
+## Java HEAP and GC
Operations on git repositories can consume lots of memory. If you consume more
memory than your java heap, your server may either run out of memory and fail,
@@ -145,14 +150,14 @@
--------------------------------------------------------------------------------
-# Replication
+## Replication
There are many scalability issues which can plague replication, most are related
to high ref counts, those are not specifically mentioned here, so you will
likely need to first be familiar with the "High Ref Counts" section to make
replication run smoothly.
-## JSch
+### JSch
Jsch has threading issues which seem to serialize replication even across worker
groups. This has lead some teams to perform replication without using ssh (Jsch
@@ -162,7 +167,7 @@
particularly useful if you have sites which replicate to at very different
speeds.
-## Failed To Lock
+### Failed To Lock
With older versions of the replication plug-in, your replication can start
running into contention and failing with "Failed to Lock" errors in your logs.
@@ -178,20 +183,20 @@
--------------------------------------------------------------------------------
-# High Ref Counts
+## High Ref Counts
High ref counts can have impacts in many places in the git/jgit/Gerrit stacks.
There are many ongoing fixes and tweaks to alleviated many of these problems,
but some of them still remain. Some can be "unofficially" worked around.
-## git daemon mirrors
+### git daemon mirrors
Current versions (prior to git 1.7.11) will use an [excessive amount of CPU]
(http://marc.info/?l=git&m=133310001303068&w=2) when receiving pushes on sites
with high ref counts. Upgrading git there can help drastically reduce your
replication time in these cases.
-## git
+### git
Suggest to your users that they use the latest git possible, many of the older
versions (which are still the defaults on many distros) have severe problems
@@ -200,7 +205,7 @@
1.7.7. Git 1.8.1 seems to have some speed-ups in fetches of high ref counts
compared to even 1.7.8.
-## jgit
+### jgit
jGit still has a [performance problem]
(http://groups.google.com/group/repo-discuss/browse_thread/thread/d0914922dc565516)
@@ -212,7 +217,7 @@
There are some very high performance patches which make jgit extremely fast.
-## Tags
+### Tags
If you have android repositories, you likely use around 400-600 of them. Cross
project tagging can be [problematic]
@@ -221,7 +226,7 @@
--------------------------------------------------------------------------------
-## ACLS
+### ACLS
On servers with little or no anonymous access, and large change counts, it can
be disastrous when non-logged-in users access a change-list page. A change-list
@@ -241,7 +246,7 @@
--------------------------------------------------------------------------------
-# Disk Space / File Cleanup
+## Disk Space / File Cleanup
Installations which do not have enough spare disk space for their repos can run
into problems easily. Be aware that git repos contain highly compressed data and
@@ -252,7 +257,7 @@
This is particularly important for those using SSDs where they might be more
likely to skimp on space.
-## Git GC Repo Explosions
+### Git GC Repo Explosions
Under certain conditions git gc can cause a repo explosion (jgit gc does not
suffer from this problem because it puts unreachable objects in a packfile),
@@ -267,7 +272,7 @@
* Tags are [deleted](http://marc.info/?l=git&m=131829057610072&w=2) from the
linux repo
-## Git GC
+### Git GC
Running GC regularly is important, particularly on sites with heavy uploads.
Older versions of jgit do not have built in gc and require using git gc. Setting
@@ -280,7 +285,7 @@
Pack file churn can lead to several issues, RAM utilization, Disk utilization
and excessive WAN utilization for file-system mirroring scripts (such as rysnc).
-## Keep and Noz files
+### Keep and Noz files
Currently, Gerrit may leave behind some temporary files in your git repos when
it shuts down (particularly if ungraceful). There are some temporary files which
@@ -290,14 +295,14 @@
repacking the packfile they are associated with which can lead to poor disk
space utilization and performance issues.
-## ~/.gerritcodereview
+### ~/.gerritcodereview
The temporary unjared war files in here can build up. (This has been move to
review\_site/tmp in Gerrit 2.5+)
--------------------------------------------------------------------------------
-# hooks
+## hooks
Servers with lots of RAM are susceptible to slow forks which can delay each hook
invocation quite a bit. When java uses over 10G of memory, it may add at least a
diff --git a/docs/ShowCases.md b/jekyll-source/pages/site/docs/ShowCases.md
similarity index 92%
rename from docs/ShowCases.md
rename to jekyll-source/pages/site/docs/ShowCases.md
index d3bc57a..fe10eaf 100644
--- a/docs/ShowCases.md
+++ b/jekyll-source/pages/site/docs/ShowCases.md
@@ -1,4 +1,9 @@
-# Gerrit Installations in the Wild
+---
+title: "Showcases"
+permalink: showcases.html
+---
+
+## Gerrit Installations in the Wild
## Open Source Projects
diff --git a/docs/SqlMergeUserAccounts.md b/jekyll-source/pages/site/docs/SqlMergeUserAccounts.md
similarity index 97%
rename from docs/SqlMergeUserAccounts.md
rename to jekyll-source/pages/site/docs/SqlMergeUserAccounts.md
index 7513711..ad69d2b 100644
--- a/docs/SqlMergeUserAccounts.md
+++ b/jekyll-source/pages/site/docs/SqlMergeUserAccounts.md
@@ -1,4 +1,9 @@
-# Introduction
+---
+title: "SQL Merge User Accounts"
+permalink: sqlmergeuseraccounts.html
+---
+
+## Introduction
Sometimes users wind up with two accounts on a Gerrit server, this is especially
common with OpenID installations when the user forgets which OpenID provider he
@@ -18,7 +23,7 @@
commit it at the end. This allows the administrator to double check any records
by query before committing the merge result for good.
-# load\_merge.sql
+## load\_merge.sql
```
CREATE TEMP TABLE links
@@ -79,7 +84,7 @@
ORDER BY t.preferred_email;
```
-# merge\_accounts.sql
+## merge\_accounts.sql
```
DROP TABLE to_del;
diff --git a/issues.md b/jekyll-source/pages/site/issues.md
similarity index 97%
rename from issues.md
rename to jekyll-source/pages/site/issues.md
index f7f695e..b64d1aa 100644
--- a/issues.md
+++ b/jekyll-source/pages/site/issues.md
@@ -1,11 +1,13 @@
-# Issue Tracking
+---
+title: "Issue Tracking"
+sidebar: gerritdoc_sidebar
+permalink: issues.html
+---
[Issues][list] are tracked at bugs.chromium.org.
[list]: https://bugs.chromium.org/p/gerrit/issues/list?can=2
-[TOC]
-
## Status
Issues that do not have a contributor actively working on them may be
diff --git a/releases/2.12.md b/jekyll-source/pages/site/releases/2.12.md
similarity index 99%
rename from releases/2.12.md
rename to jekyll-source/pages/site/releases/2.12.md
index dcad1cc..c5bce9e 100644
--- a/releases/2.12.md
+++ b/jekyll-source/pages/site/releases/2.12.md
@@ -1,4 +1,7 @@
-# Gerrit 2.12
+---
+title: "Gerrit 2.12 Release"
+permalink: 2.12.html
+---
Download: **[2.12.7](https://gerrit-releases.storage.googleapis.com/gerrit-2.12.7.war)**
| [2.12.6](https://gerrit-releases.storage.googleapis.com/gerrit-2.12.6.war)
diff --git a/releases/2.13.md b/jekyll-source/pages/site/releases/2.13.md
similarity index 99%
rename from releases/2.13.md
rename to jekyll-source/pages/site/releases/2.13.md
index dd2bdca..9faabd4 100644
--- a/releases/2.13.md
+++ b/jekyll-source/pages/site/releases/2.13.md
@@ -1,4 +1,7 @@
-# Gerrit 2.13
+---
+title: "Gerrit 2.13 Release"
+permalink: 2.13.html
+---
Download: **[2.13.9](https://gerrit-releases.storage.googleapis.com/gerrit-2.13.9.war)**
| [2.13.8](https://gerrit-releases.storage.googleapis.com/gerrit-2.13.8.war)
diff --git a/releases/2.14.md b/jekyll-source/pages/site/releases/2.14.md
similarity index 99%
rename from releases/2.14.md
rename to jekyll-source/pages/site/releases/2.14.md
index 17960a4..57cb234 100644
--- a/releases/2.14.md
+++ b/jekyll-source/pages/site/releases/2.14.md
@@ -1,4 +1,7 @@
-# Gerrit 2.14
+---
+title: "Gerrit 2.14 Release"
+permalink: 2.14.html
+---
Download: **[2.14.3](https://gerrit-releases.storage.googleapis.com/gerrit-2.14.3.war)**
| [2.14.2](https://gerrit-releases.storage.googleapis.com/gerrit-2.14.2.war)
diff --git a/releases/2.15.md b/jekyll-source/pages/site/releases/2.15.md
similarity index 95%
rename from releases/2.15.md
rename to jekyll-source/pages/site/releases/2.15.md
index 2a50d4c..53c9795 100644
--- a/releases/2.15.md
+++ b/jekyll-source/pages/site/releases/2.15.md
@@ -1,6 +1,7 @@
-# Gerrit 2.15 *(In development)*
-
-[TOC]
+---
+title: "Gerrit 2.15 Release (In Development)"
+permalink: 2.15.html
+---
## Release Highlights
diff --git a/releases/README.md b/jekyll-source/pages/site/releases/README.md
similarity index 82%
rename from releases/README.md
rename to jekyll-source/pages/site/releases/README.md
index fb54bcb..977c4e8 100644
--- a/releases/README.md
+++ b/jekyll-source/pages/site/releases/README.md
@@ -7,7 +7,7 @@
(.war files and API artifacts, version 2.9 and later).
Artifacts deployed to Maven Central are signed with the maintainer's key.
-Please refer to the [list of maintainers' keys](public-keys.md).
+Please refer to the [list of maintainers' keys](public-keys.html).
Latest release: **[2.14.3](/releases/2.14.md)**.
@@ -17,7 +17,7 @@
* Private Changes
-[Release notes for Gerrit 2.15](/releases/2.15.md)
+[Release notes for Gerrit 2.15](/releases/2.15.html)
## 2.14 {#2.14}
@@ -35,7 +35,7 @@
* Secondary index with Elastic Search (experimental)
-[Release notes for Gerrit 2.14](/releases/2.14.md)
+[Release notes for Gerrit 2.14](/releases/2.14.html)
## 2.13 {#2.13}
@@ -47,7 +47,7 @@
* Access control for git submodule subscriptions
-[Release notes for Gerrit 2.13](/releases/2.13.md).
+[Release notes for Gerrit 2.13](/releases/2.13.html).
## 2.12 {#2.12}
@@ -55,7 +55,7 @@
* Support for GPG Keys and signed pushes.
-[Release notes for Gerrit 2.12](/releases/2.12.md).
+[Release notes for Gerrit 2.12](/releases/2.12.html).
## Older Releases {#older}
diff --git a/releases/public-keys.md b/jekyll-source/pages/site/releases/public-keys.md
similarity index 96%
rename from releases/public-keys.md
rename to jekyll-source/pages/site/releases/public-keys.md
index 2d09e15..2621009 100644
--- a/releases/public-keys.md
+++ b/jekyll-source/pages/site/releases/public-keys.md
@@ -1,4 +1,7 @@
-# Gerrit Code Review - Public Keys
+---
+title: "Public Keys"
+permalink: public-keys.html
+---
The following public keys are are available on the
[Ubuntu Public Key Server](https://keyserver.ubuntu.com/), and are used to sign:
diff --git a/navbar.md b/navbar.md
deleted file mode 100644
index 9ff5dc5..0000000
--- a/navbar.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Gerrit Code Review
-
-* [About](/about.md)
-* [Releases](/releases/README.md)
-* [Documentation](https://gerrit-documentation.storage.googleapis.com/Documentation/2.14.3/index.html)
-* [Issues](/issues.md)
-* [Wiki](https://gerrit.googlesource.com/homepage/+/md-pages/docs/)
-* [Source](https://gerrit.googlesource.com/gerrit/)
-* [Reviews](https://gerrit-review.googlesource.com/#/q/status:open+project:gerrit)
-* [Builds](https://gerrit-ci.gerritforge.com)
-
-[home]: /index.md
-[logo]: /images/diffy45.png
