all there.

Author: RossBugginsNHS

_includes/tags.html

@@ -19,7 +19,8 @@
 <h3> <a href="{{tag_path | relative_url}}"> {{tag.name}}</a>: {{tag.size}}</h3>
 
 <ul>
-{%- for doc in site_pages -%}
+{%- assign sorted_docs = site_pages | sort: "title" -%}    
+{%- for doc in sorted_docs -%}
 {%- if doc.tags contains tag.name -%}
 <li><a href="{{doc.url | relative_url}}">{{doc.title}}{%- if doc.description -%}: {{doc.description}}{%- endif -%}</a></li>
 {%- endif -%}

_plugins/tags.rb

@@ -51,9 +51,16 @@ def initialize(site, group, count, counter)
         @content = "<div>" + group + ": " + count.to_s + "</div>"
 
         @content += "<div><ul>"
-        site.collections['safs'].docs.each do |saf|
+
+        safs = site.collections['safs'].docs
+        sorted_safs = safs.sort_by {|title| title.data['title'].downcase}
+        sorted_safs.each do |saf|
           if saf.data['tags'].include? group
-            @content += "<li><a href=\"..#{saf.url}\">#{saf.data['title']}</a></li>"
+            title = saf.data['title']
+            if saf.data['description'] != nil
+              title += ": " + saf.data['description']
+            end
+            @content += "<li><a href=\"..#{saf.url}\">#{title}</a></li>"
           end
         end
         @content += "</ul></div>"

_saf_dimensions/choices.md

@@ -2,7 +2,7 @@
 name: choices
 code: T
 title: Technology Choices
-description: Are we making the right technology choices in line with our technology radar and other strategic choices?
+description: Strategic choices
 nav_order: 3.4
 ---
 

_saf_dimensions/decisions.md

@@ -2,7 +2,7 @@
 name: decisions
 code: DM
 title: Decision Making & Governance 
-description: Are we following governance processes, managing risk and issues, communicating with our stakeholders? Are we managing technical debt? Do we have a framework in place to make decisions which is based are based on understanding need, options analysis, clear rationale, and management of trade-offs? Are we communicating those decisions? 
+description: Governance processes
 nav_order: 3.2
 ---
 

_saf_dimensions/documentation.md

@@ -2,7 +2,7 @@
 name: documentation
 code: D
 title: Documentation
-description: Are we documenting the architectures to an appropriate level of detail, are we following our standards around Enterprise Architecture tooling. Is documentation open and shared? 
+description: Documenting the architectures
 nav_order: 3.6
 ---
 

_saf_dimensions/non_functional.md

@@ -2,7 +2,7 @@
 name: non functional
 code: NF
 title: Non-Functional Design 
-description: Do we understand the non-functional needs of the service, are we creating a solution which can meet those need and be flexible, without over engineering? 
+description: Understand non-functional needs
 nav_order: 3.4
 ---
 Do we understand the non-functional needs of the service, are we creating a solution which can meet those need and be flexible, without over engineering? 

_saf_dimensions/reuse.md

@@ -2,7 +2,7 @@
 name: reuse
 code: RU
 title: Re Use Principles and Development of Shared Services 
-description: Are we building re-useable components, are we reusing what we have already in an effective manner? 
+description: Reusing what we have already
 nav_order: 3.5
 ---
 

_saf_dimensions/solution.md

@@ -2,7 +2,7 @@
 name: solution
 code: SD
 title: Solution Design & Methods 
-description: Are we following recognised industry best practice in our designs e.g. separation of concerns? Are we giving sufficient focus to ensure interoperability / integration is built into our designs from day 1, using the right patterns and standards? 
+description: Following recognised industry best practice
 nav_order: 3.3
 ---
 

_saf_dimensions/strategic.md

@@ -2,7 +2,7 @@
 name: strategic
 code: S
 title: Strategic Alignment, Vision, and Roadmap 
-description: Describes how well the solution architecture aligns with our strategic direction, our policies, and principles. 
+description: Alignment with our strategic direction
 nav_order: 3.1
 ---
 

_safs/d/d01.md

@@ -1,6 +1,6 @@
 ---
 title: D01
-description: Documentation
+description: Documentation Stores
 dimension: documentation
 tags: [documentation,knowledge]
 nav_order: 2.71