Add support for including blog posts on Gerrit site.
Files updated:
_data/topnav.yml: Add News link to top navigation.
_pages/site/publishing-gerrit-docs.md: Info on how to add blog posts.
New files:
_posts/2018-09-06-gerrit-ux-newsletter-jun-aug-2018.md: New blog post
images (various): Images for blog post
pages/news/news.html: Main page to display current blog posts
pages/news/news_archive.html: Page to display all blog posts
View on staging:
https://gerrit-content-staging.firebaseapp.com/
Change-Id: I4899325710be880915993b837fa85b559cfcb739
diff --git a/_data/topnav.yml b/_data/topnav.yml
index 4425eb5..93578ea 100644
--- a/_data/topnav.yml
+++ b/_data/topnav.yml
@@ -5,6 +5,8 @@
items:
- title: About
url: /about.html
+ - title: News
+ url: /news.html
- title: Issues
url: /issues.html
#Topnav dropdowns
diff --git a/_posts/2018-09-06-gerrit-ux-newsletter-jun-aug-2018.md b/_posts/2018-09-06-gerrit-ux-newsletter-jun-aug-2018.md
new file mode 100644
index 0000000..92a2f1c
--- /dev/null
+++ b/_posts/2018-09-06-gerrit-ux-newsletter-jun-aug-2018.md
@@ -0,0 +1,105 @@
+---
+title: Gerrit UX Newsletter Jun-Aug 2018
+tags: ux
+keywords: ux
+permalink: 2018-09-06-gerrit-ux-newsletter-jun-aug-2018.html
+summary: "This is the first in a series of newsletters we’ll send out each
+quarter to update you on the UX related stuff that we have been working on in
+Gerrit, and things that you can expect to see in Gerrit in the near future."
+hide_sidebar: true
+hide_navtoggle: true
+toc: true
+---
+
+<p style="text-align: center;">
+<img src="images/code-review-icon.png" width="" alt="Gerrit Code Review Icon" title="Gerrit Code Review">
+</p>
+
+Hello, Gerrit users! This is the first in a series of newsletters that we'll
+send out each quarter to update you on the UX related stuff that we have been
+working on in Gerrit. We'll also discuss features and changes that you can
+expect to see in the near future.
+
+## Things we worked on this quarter
+
+### Updated labels interface
+
+<img style="max-width: 50%; max-height: 50%" src="images/updated-labels-interface.png" width="" alt="Screenshot of Updated Labels Interface feature" title="Updated Label Interface Feature">
+
+The presentation of labels was updated to make better use of space, and address
+issues such as
+<a href="https://bugs.chromium.org/p/gerrit/issues/detail?id=8882">this bug</a>.
+All labels now appear in two sections, Required labels and Other labels. This
+design solves two UX issues:
+
++ Merging the submit requirements and votes sections has helped us avoid
+ repeating all the labels under both sections, reducing the vertical real
+ estate required to display a large number of labels.
++ The Other labels section can now be collapsed so in case of a large number of
+ labels, users can collapse the list to get to the file list quickly.
+
+### Image diff
+
+<img src="images/image-diff.png" width="" alt="Screenshot of Image Diff feature" title="Image Diff Feature">
+
+You now have more tools to compare images. The new
+<a href="https://gerrit.googlesource.com/plugins/image-diff/">image diffing plugin</a>
+adds new modes that make it easier to quickly locate small differences between
+similar images.
+
+### Gerrit dark theme
+
+<img src="images/dark-theme.png" width="" alt="Screenshot of Gerrit Dark Theme feature" title="Gerrit Dark Theme">
+
+This was actually added in April during the Lund Hackathon. It can be enabled
+via the Settings menu.
+
+## What we're working on
+
+### New metadata layout
+
+<img src="images/metadata-layout.png" width="" alt="Screenshot of metadata layout feature" title="Metadata Layout Feature">
+
+The new metadata design horizontally arranges some of the metadata information
+about a change just below the change title. This frees up vertical space from
+the left section on the UI, which reduces the scrolling needed to get to the
+file list. The left section of the change is now dedicated to data about people
+and votes.
+
+### Draft comments
+
+<img src="images/draft-comments.png" width="" alt="Screenshot of draft comments feature" title="Draft Comments Feature">
+
+Have you ever drafted comments in Gerrit, but lost track of them before
+publishing? This design makes unpublished drafts more discoverable, more
+convenient to publish, and easier to navigate.
+
+We're taking them out of the Reply dialog and placing them at a more prominent
+location on the UI. This decouples the Start review action for WIP changes with
+the Publish drafts. The design also enables users to easily jump from one draft
+comment to another from the file view using the Draft comments panel.
+
+### Patchset navigation
+
+<img src="images/patchset-navigation.png" width="" alt="Screenshot of patchset navigation feature" title="Patchset Navigation Feature">
+
+Informed by bug reports <a href="https://bugs.chromium.org/p/gerrit/issues/detail?id=5946">like this one</a>,
+the redesign adds:
+
++ A single drop-down to select patchsets that reduces visual focus shifts and
+ clicks to compare two patchsets.
++ Showing a better representation of patchset history that shows when the
+ rebases happened and more prominent indication for unresolved comments.
++ An expandable Patchset info panel that shows a lot of other relevant
+ information about the patchsets such as commenters, number of total and
+ unresolved comments and votes for each patchset.
++ A quick way to view all the unresolved comments for a selected patchset by
+ clicking the number link under the unresolved comments column inside the
+ Patchset Info panel.
+
+Authors: <a href="mailto:arnabb@google.com">arnabb@google.com</a>,
+<a href="mailto:kaspern@google.com">kaspern@google.com</a>,
+<a href="mailto:wyatta@google.com">wyatta@google.com</a>
+
+Bugs? Feedback? <a href="https://bugs.chromium.org/p/gerrit/issues/entry?template=PolyGerrit+Issue">File it here!</a>
+
diff --git a/images/code-review-icon.png b/images/code-review-icon.png
new file mode 100644
index 0000000..ffda6eb
--- /dev/null
+++ b/images/code-review-icon.png
Binary files differ
diff --git a/images/dark-theme.png b/images/dark-theme.png
new file mode 100644
index 0000000..b87b9a4
--- /dev/null
+++ b/images/dark-theme.png
Binary files differ
diff --git a/images/draft-comments.png b/images/draft-comments.png
new file mode 100644
index 0000000..55022e8
--- /dev/null
+++ b/images/draft-comments.png
Binary files differ
diff --git a/images/image-diff.png b/images/image-diff.png
new file mode 100644
index 0000000..bbc59e8
--- /dev/null
+++ b/images/image-diff.png
Binary files differ
diff --git a/images/metadata-layout.png b/images/metadata-layout.png
new file mode 100644
index 0000000..a0a9aaf
--- /dev/null
+++ b/images/metadata-layout.png
Binary files differ
diff --git a/images/patchset-navigation.png b/images/patchset-navigation.png
new file mode 100644
index 0000000..b08a1bc
--- /dev/null
+++ b/images/patchset-navigation.png
Binary files differ
diff --git a/images/updated-labels-interface.png b/images/updated-labels-interface.png
new file mode 100644
index 0000000..102792b
--- /dev/null
+++ b/images/updated-labels-interface.png
Binary files differ
diff --git a/pages/news/news.html b/pages/news/news.html
new file mode 100644
index 0000000..c625da1
--- /dev/null
+++ b/pages/news/news.html
@@ -0,0 +1,34 @@
+---
+title: News
+sidebar: home_sidebar
+keywords: news, blog, updates, release notes, announcements
+permalink: news.html
+toc: false
+hide_sidebar: true
+hide_navtoggle: true
+folder: news
+---
+<div class="home">
+
+ <div class="post-list">
+ {% for post in site.posts limit:10 %}
+
+
+ <h2><a class="post-link" href="{{ post.url | remove: "/" }}">{{ post.title }}</a></h2>
+ <span class="post-meta">{{ post.date | date: "%b %-d, %Y" }} /
+ {% for tag in post.tags %}
+
+ <a href="{{ "tag_" | append: tag | append: ".html"}}">{{tag}}</a>{% unless forloop.last %}, {% endunless%}
+
+ {% endfor %}</span>
+ <p>{% if page.summary %} {{ page.summary | strip_html | strip_newlines | truncate: 160 }} {% else %} {{ post.content | truncatewords: 50 | strip_html }} {% endif %}</p>
+
+ {% endfor %}
+ {% comment %}
+ <p><a href="feed.xml" class="btn btn-primary navbar-btn cursorNorm" role="button">RSS Subscribe{{tag}}</a></p>
+ {% endcomment %}
+<hr />
+ <p>See more posts from the <a href="news_archive.html">News Archive</a>. </p>
+
+ </div>
+</div>
diff --git a/pages/news/news_archive.html b/pages/news/news_archive.html
new file mode 100644
index 0000000..955ab83
--- /dev/null
+++ b/pages/news/news_archive.html
@@ -0,0 +1,37 @@
+---
+title: News
+sidebar: mydoc_sidebar
+keywords: news, blog, updates, release notes, announcements
+permalink: news_archive.html
+toc: false
+hide_sidebar: true
+hide_navtoggle: true
+folder: news
+---
+
+<div class="home">
+
+ <div class="post-list">
+
+
+ <section id="archive">
+ <h3>This year's posts</h3>
+ {%for post in site.posts %}
+ {% unless post.next %}
+ <ul class="this">
+ {% else %}
+ {% capture year %}{{ post.date | date: '%Y' }}{% endcapture %}
+ {% capture nyear %}{{ post.next.date | date: '%Y' }}{% endcapture %}
+ {% if year != nyear %}
+ </ul>
+ <h3>{{ post.date | date: '%Y' }}</h3>
+ <ul class="past">
+ {% endif %}
+ {% endunless %}
+ <li><time>{{ post.date | date:"%d %b" }}</time><a href="{{ post.url | remove: "/"}}">{{ post.title }}</a></li>
+ {% endfor %}
+ </ul>
+ </section>
+ <hr/>
+ </div>
+</div>
diff --git a/pages/site/publishing-gerrit-docs.md b/pages/site/publishing-gerrit-docs.md
index c1e1355..7b590be 100644
--- a/pages/site/publishing-gerrit-docs.md
+++ b/pages/site/publishing-gerrit-docs.md
@@ -144,6 +144,44 @@
For more information on how the documentation is structured and the syntax it
supports, see the [template documentation](http://idratherbewriting.com/documentation-theme-jekyll/).
+### Writing blog posts
+
+The Gerrit website supports adding blog posts. Users can view a list of
+current blogposts by click the **News** link in the navigation bar.
+
+To create a blog post:
+
+1. Create a new markdown file. The name of the file must use this format:
+
+ YYYY-MM-DD-[permalink].md
+
+ Where `[permalink]` is a descriptive name of the file.
+
+1. Add the following to the top of the blog post:
+
+ ---
+ title: [TITLE]
+ tags: [TAGS]
+ keywords: [KEYWORDS]
+ permalink: [FILENAME].html
+ summary: [SUMMARY]
+ hide_sidebar: true
+ hide_navtoggle: true
+ toc: true
+ ---
+
+ Where:
+
+ + `[TITLE]` is the title of the blog post
+ + `[TAGS]` is an optional comma-delimited list of tags
+ + `[KEYWORDS]` is an optional comma-delimited list of keywords
+ + `[FILENAME]` is the name of the file
+ + `[SUMMARY]` is a one- to two- sentence description of the post
+
+1. Save the new post in the `_posts` directory.
+
+1. Save any images in the top-level `images` directory.
+
## Appendix: Logging in to Firebase
If you have never used Firebase before, you need to perform these steps: