Fix typo

Update deployment documentation

See merge request autonomic-cooperative/autonomic-cooperative.gitlab.io!19

.gitlab-ci.yml

@@ -1,14 +1,28 @@
 image: ruby:2.4.2
 
-pages:
+stages:
+  - build
+  - deploy
+
+build:
   stage: build
-  script:
+  before_script:
     - gem install jekyll
+  script:
     - jekyll build -d public
-  - gem build autonomic.gemspec
   artifacts:
     paths:
       - public
-    - "autonomic-*.gem"
+
+deploy:
+  stage: deploy
+  before_script:
+    - gem install jekyll
+  script:
+    - jekyll build -d public
+    - ./bin/deploy
+  artifacts:
+    paths:
+      - public
   only:
-  - master
+    - tags

CHANGELOG.md

@@ -0,0 +1,24 @@
+# Change Log
+
+All notable changes to this project will be documented in this file. The format
+is based on [Keep a Changelog] and this project adheres to [Semantic Versioning].
+
+[Keep a Changelog]: http://keepachangelog.com/en/1.0.0/
+[Semantic Versioning]: http://semver.org/spec/v2.0.0.html
+
+## [1.0.2] - 2017-11-05
+
+## Added
+- [#18]: Add shared account email.
+
+[#18]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/merge_requests/18
+
+## [1.0.1] - 2017-10-14
+
+## Added
+- [#17]: Added automated Gitlab CI production builds.
+
+[#17]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/merge_requests/17
+
+## [1.0.0] - 2017-10-04
+- Initial Release

CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing
+
+# What Is Jekyll
+
+For those unfamiliar with how Jekyll works, check out [jekyll.rb] for all the
+details, or read up on the basics of [front matter], [writing posts] and
+[creating pages].
+
+[jekyll.rb]: https://jekyllrb.com/
+[front matter]: https://jekyllrb.com/docs/frontmatter/
+[writing posts]: https://jekyllrb.com/docs/posts/
+[creating pages]: https://jekyllrb.com/docs/pages/
+
+# Using RVM to Manage Ruby
+
+In order to not blow up your computer handling a system wide Ruby installation, it is
+advised that you use [RVM](https://rvm.io/rvm/install).
+
+Once you've got that installed and configured, get the latest version of Ruby with:
+
+```bash
+$ rvm install 2.4.2
+```
+
+Select that version and then create an isolated [gemset](https://rvm.io/gemsets/basics) with:
+
+```bash
+$ rvm use 2.4.2
+$ rvm gemset create autonomic
+$ rvm gemset use autonomic
+```
+
+# Install Dependencies
+
+Then you can get your Ruby dependencies installed with:
+
+``` bash
+$ gem install jekyll bundler
+```
+
+# Serve Website
+
+And serve the website locally with:
+
+``` bash
+$ make devserver
+```
+
+# Editing Content
+
+You can edit content in the `.md` files under `src` and `src/_posts`.
+
+# Manage Gemset
+
+When you're hacking later on (or in a new shell), you'll need to run:
+
+``` bash
+$ rvm use 2.4.2
+$ rvm gemset use autonomic
+```
+
+And then you'll have access to the environment.

LICENSE

@@ -0,0 +1,259 @@
+Creative Commons Attribution 3.0 Unported
+http://creativecommons.org/licenses/by/3.0/
+
+License
+
+THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE
+COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY
+COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS
+AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
+
+BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE
+BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS LICENSE MAY BE
+CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE
+IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.
+
+1. Definitions
+
+   1. "Adaptation" means a work based upon the Work, or upon the Work and other
+   pre-existing works, such as a translation, adaptation, derivative work,
+   arrangement of music or other alterations of a literary or artistic work, or
+   phonogram or performance and includes cinematographic adaptations or any
+   other form in which the Work may be recast, transformed, or adapted
+   including in any form recognizably derived from the original, except that a
+   work that constitutes a Collection will not be considered an Adaptation for
+   the purpose of this License. For the avoidance of doubt, where the Work is a
+   musical work, performance or phonogram, the synchronization of the Work in
+   timed-relation with a moving image ("synching") will be considered an
+   Adaptation for the purpose of this License.  2. "Collection" means a
+   collection of literary or artistic works, such as encyclopedias and
+   anthologies, or performances, phonograms or broadcasts, or other works or
+   subject matter other than works listed in Section 1(f) below, which, by
+   reason of the selection and arrangement of their contents, constitute
+   intellectual creations, in which the Work is included in its entirety in
+   unmodified form along with one or more other contributions, each
+   constituting separate and independent works in themselves, which together
+   are assembled into a collective whole. A work that constitutes a Collection
+   will not be considered an Adaptation (as defined above) for the purposes of
+   this License.  3. "Distribute" means to make available to the public the
+   original and copies of the Work or Adaptation, as appropriate, through sale
+   or other transfer of ownership.  4. "Licensor" means the individual,
+   individuals, entity or entities that offer(s) the Work under the terms of
+   this License.  5. "Original Author" means, in the case of a literary or
+   artistic work, the individual, individuals, entity or entities who created
+   the Work or if no individual or entity can be identified, the publisher; and
+   in addition (i) in the case of a performance the actors, singers, musicians,
+   dancers, and other persons who act, sing, deliver, declaim, play in,
+   interpret or otherwise perform literary or artistic works or expressions of
+   folklore; (ii) in the case of a phonogram the producer being the person or
+   legal entity who first fixes the sounds of a performance or other sounds;
+   and, (iii) in the case of broadcasts, the organization that transmits the
+   broadcast.  6. "Work" means the literary and/or artistic work offered under
+   the terms of this License including without limitation any production in the
+   literary, scientific and artistic domain, whatever may be the mode or form
+   of its expression including digital form, such as a book, pamphlet and other
+   writing; a lecture, address, sermon or other work of the same nature; a
+   dramatic or dramatico-musical work; a choreographic work or entertainment in
+   dumb show; a musical composition with or without words; a cinematographic
+   work to which are assimilated works expressed by a process analogous to
+   cinematography; a work of drawing, painting, architecture, sculpture,
+   engraving or lithography; a photographic work to which are assimilated works
+   expressed by a process analogous to photography; a work of applied art; an
+   illustration, map, plan, sketch or three-dimensional work relative to
+   geography, topography, architecture or science; a performance; a broadcast;
+   a phonogram; a compilation of data to the extent it is protected as a
+   copyrightable work; or a work performed by a variety or circus performer to
+   the extent it is not otherwise considered a literary or artistic work.  7.
+   "You" means an individual or entity exercising rights under this License who
+   has not previously violated the terms of this License with respect to the
+   Work, or who has received express permission from the Licensor to exercise
+   rights under this License despite a previous violation.  8. "Publicly
+   Perform" means to perform public recitations of the Work and to communicate
+   to the public those public recitations, by any means or process, including
+   by wire or wireless means or public digital performances; to make available
+   to the public Works in such a way that members of the public may access
+   these Works from a place and at a place individually chosen by them; to
+   perform the Work to the public by any means or process and the communication
+   to the public of the performances of the Work, including by public digital
+   performance; to broadcast and rebroadcast the Work by any means including
+   signs, sounds or images.  9. "Reproduce" means to make copies of the Work by
+   any means including without limitation by sound or visual recordings and the
+   right of fixation and reproducing fixations of the Work, including storage
+   of a protected performance or phonogram in digital form or other electronic
+   medium.
+
+2. Fair Dealing Rights. Nothing in this License is intended to reduce, limit,
+or restrict any uses free from copyright or rights arising from limitations or
+exceptions that are provided for in connection with the copyright protection
+under copyright law or other applicable laws.
+
+3. License Grant. Subject to the terms and conditions of this License, Licensor
+hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the
+duration of the applicable copyright) license to exercise the rights in the
+Work as stated below:
+
+   1. to Reproduce the Work, to incorporate the Work into one or more
+   Collections, and to Reproduce the Work as incorporated in the Collections;
+   2. to create and Reproduce Adaptations provided that any such Adaptation,
+   including any translation in any medium, takes reasonable steps to clearly
+   label, demarcate or otherwise identify that changes were made to the
+   original Work. For example, a translation could be marked "The original work
+   was translated from English to Spanish," or a modification could indicate
+   "The original work has been modified."; 3. to Distribute and Publicly
+   Perform the Work including as incorporated in Collections; and, 4. to
+   Distribute and Publicly Perform Adaptations.  5.
+
+      For the avoidance of doubt: 1. Non-waivable Compulsory License Schemes.
+      In those jurisdictions in which the right to collect royalties through
+      any statutory or compulsory licensing scheme cannot be waived, the
+      Licensor reserves the exclusive right to collect such royalties for any
+      exercise by You of the rights granted under this License; 2. Waivable
+      Compulsory License Schemes. In those jurisdictions in which the right to
+      collect royalties through any statutory or compulsory licensing scheme
+      can be waived, the Licensor waives the exclusive right to collect such
+      royalties for any exercise by You of the rights granted under this
+      License; and, 3. Voluntary License Schemes. The Licensor waives the right
+      to collect royalties, whether individually or, in the event that the
+      Licensor is a member of a collecting society that administers voluntary
+      licensing schemes, via that society, from any exercise by You of the
+      rights granted under this License.
+
+The above rights may be exercised in all media and formats whether now known or
+hereafter devised. The above rights include the right to make such
+modifications as are technically necessary to exercise the rights in other
+media and formats. Subject to Section 8(f), all rights not expressly granted by
+Licensor are hereby reserved.
+
+4. Restrictions. The license granted in Section 3 above is expressly made
+subject to and limited by the following restrictions:
+
+   1. You may Distribute or Publicly Perform the Work only under the terms of
+   this License. You must include a copy of, or the Uniform Resource Identifier
+   (URI) for, this License with every copy of the Work You Distribute or
+   Publicly Perform. You may not offer or impose any terms on the Work that
+   restrict the terms of this License or the ability of the recipient of the
+   Work to exercise the rights granted to that recipient under the terms of the
+   License. You may not sublicense the Work. You must keep intact all notices
+   that refer to this License and to the disclaimer of warranties with every
+   copy of the Work You Distribute or Publicly Perform. When You Distribute or
+   Publicly Perform the Work, You may not impose any effective technological
+   measures on the Work that restrict the ability of a recipient of the Work
+   from You to exercise the rights granted to that recipient under the terms of
+   the License. This Section 4(a) applies to the Work as incorporated in a
+   Collection, but this does not require the Collection apart from the Work
+   itself to be made subject to the terms of this License. If You create a
+   Collection, upon notice from any Licensor You must, to the extent
+   practicable, remove from the Collection any credit as required by Section
+   4(b), as requested. If You create an Adaptation, upon notice from any
+   Licensor You must, to the extent practicable, remove from the Adaptation any
+   credit as required by Section 4(b), as requested.  2. If You Distribute, or
+   Publicly Perform the Work or any Adaptations or Collections, You must,
+   unless a request has been made pursuant to Section 4(a), keep intact all
+   copyright notices for the Work and provide, reasonable to the medium or
+   means You are utilizing: (i) the name of the Original Author (or pseudonym,
+   if applicable) if supplied, and/or if the Original Author and/or Licensor
+   designate another party or parties (e.g., a sponsor institute, publishing
+   entity, journal) for attribution ("Attribution Parties") in Licensor's
+   copyright notice, terms of service or by other reasonable means, the name of
+   such party or parties; (ii) the title of the Work if supplied; (iii) to the
+   extent reasonably practicable, the URI, if any, that Licensor specifies to
+   be associated with the Work, unless such URI does not refer to the copyright
+   notice or licensing information for the Work; and (iv) , consistent with
+   Section 3(b), in the case of an Adaptation, a credit identifying the use of
+   the Work in the Adaptation (e.g., "French translation of the Work by
+   Original Author," or "Screenplay based on original Work by Original
+   Author"). The credit required by this Section 4 (b) may be implemented in
+   any reasonable manner; provided, however, that in the case of a Adaptation
+   or Collection, at a minimum such credit will appear, if a credit for all
+   contributing authors of the Adaptation or Collection appears, then as part
+   of these credits and in a manner at least as prominent as the credits for
+   the other contributing authors. For the avoidance of doubt, You may only use
+   the credit required by this Section for the purpose of attribution in the
+   manner set out above and, by exercising Your rights under this License, You
+   may not implicitly or explicitly assert or imply any connection with,
+   sponsorship or endorsement by the Original Author, Licensor and/or
+   Attribution Parties, as appropriate, of You or Your use of the Work, without
+   the separate, express prior written permission of the Original Author,
+   Licensor and/or Attribution Parties.  3. Except as otherwise agreed in
+   writing by the Licensor or as may be otherwise permitted by applicable law,
+   if You Reproduce, Distribute or Publicly Perform the Work either by itself
+   or as part of any Adaptations or Collections, You must not distort,
+   mutilate, modify or take other derogatory action in relation to the Work
+   which would be prejudicial to the Original Author's honor or reputation.
+   Licensor agrees that in those jurisdictions (e.g. Japan), in which any
+   exercise of the right granted in Section 3(b) of this License (the right to
+   make Adaptations) would be deemed to be a distortion, mutilation,
+   modification or other derogatory action prejudicial to the Original Author's
+   honor and reputation, the Licensor will waive or not assert, as appropriate,
+   this Section, to the fullest extent permitted by the applicable national
+   law, to enable You to reasonably exercise Your right under Section 3(b) of
+   this License (right to make Adaptations) but not otherwise.
+
+5. Representations, Warranties and Disclaimer
+
+UNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING, LICENSOR OFFERS
+THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND
+CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING,
+WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A
+PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS,
+ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE.
+SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH
+EXCLUSION MAY NOT APPLY TO YOU.
+
+6. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN
+NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL,
+INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS
+LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+7. Termination
+
+   1. This License and the rights granted hereunder will terminate
+   automatically upon any breach by You of the terms of this License.
+   Individuals or entities who have received Adaptations or Collections from
+   You under this License, however, will not have their licenses terminated
+   provided such individuals or entities remain in full compliance with those
+   licenses. Sections 1, 2, 5, 6, 7, and 8 will survive any termination of this
+   License.  2. Subject to the above terms and conditions, the license granted
+   here is perpetual (for the duration of the applicable copyright in the
+   Work). Notwithstanding the above, Licensor reserves the right to release the
+   Work under different license terms or to stop distributing the Work at any
+   time; provided, however that any such election will not serve to withdraw
+   this License (or any other license that has been, or is required to be,
+   granted under the terms of this License), and this License will continue in
+   full force and effect unless terminated as stated above.
+
+8. Miscellaneous
+
+   1. Each time You Distribute or Publicly Perform the Work or a Collection,
+   the Licensor offers to the recipient a license to the Work on the same terms
+   and conditions as the license granted to You under this License.  2. Each
+   time You Distribute or Publicly Perform an Adaptation, Licensor offers to
+   the recipient a license to the original Work on the same terms and
+   conditions as the license granted to You under this License.  3. If any
+   provision of this License is invalid or unenforceable under applicable law,
+   it shall not affect the validity or enforceability of the remainder of the
+   terms of this License, and without further action by the parties to this
+   agreement, such provision shall be reformed to the minimum extent necessary
+   to make such provision valid and enforceable.  4. No term or provision of
+   this License shall be deemed waived and no breach consented to unless such
+   waiver or consent shall be in writing and signed by the party to be charged
+   with such waiver or consent.  5. This License constitutes the entire
+   agreement between the parties with respect to the Work licensed here. There
+   are no understandings, agreements or representations with respect to the
+   Work not specified here. Licensor shall not be bound by any additional
+   provisions that may appear in any communication from You. This License may
+   not be modified without the mutual written agreement of the Licensor and
+   You.  6. The rights granted under, and the subject matter referenced, in
+   this License were drafted utilizing the terminology of the Berne Convention
+   for the Protection of Literary and Artistic Works (as amended on September
+   28, 1979), the Rome Convention of 1961, the WIPO Copyright Treaty of 1996,
+   the WIPO Performances and Phonograms Treaty of 1996 and the Universal
+   Copyright Convention (as revised on July 24, 1971). These rights and subject
+   matter take effect in the relevant jurisdiction in which the License terms
+   are sought to be enforced according to the corresponding provisions of the
+   implementation of those treaty provisions in the applicable national law. If
+   the standard suite of rights granted under applicable copyright law includes
+   additional rights not granted under this License, such additional rights are
+   deemed to be included in the License; this License is not intended to
+   restrict the license of any rights under applicable law.

Makefile

@@ -0,0 +1,6 @@
+DEV_DIST_DIR:=dist
+
+devserver:
+	@echo "Serving development site from $(DEV_DIST_DIR)"
+	@jekyll serve --watch --incremental --destination $(DEV_DIST_DIR)
+.PHONY: devserver

README.md

@@ -6,56 +6,54 @@ A [Jekyll] based site for the Autonomic Cooperative.
 
 The template is based on the [spectral-jekyll-theme].
 
+We use [autonomic.zone] for production and [autonomic-cooperative.gitlab.io] for staging.
+
 [Jekyll]: https://jekyllrb.com/
 [spectral-jekyll-theme]: https://github.com/andrewbanchich/spectral-jekyll-theme
+[autonomic.zone]: https://autonomic.zone/
+[autonomic-cooperative.gitlab.io]: http://autonomic-cooperative.gitlab.io/
 
-# Quick Start
+# Contribute
 
-For those unfamiliar with how Jekyll works, check out [jekyll.rb] for all the
-details, or read up on the basics of [front matter], [writing posts] and
-[creating pages].
+Please see [CONTRIBUTING.md] for the juicy details.
 
-[jekyll.rb]: https://jekyllrb.com/
-[front matter]: https://jekyllrb.com/docs/frontmatter/
-[writing posts]: https://jekyllrb.com/docs/posts/
-[creating pages]: https://jekyllrb.com/docs/pages/
+[CONTRIBUTING.md]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/blob/master/CONTRIBUTING.md
 
-In order to not blow up your computer handling a system wide Ruby installation, it is
-advised that you use [RVM](https://rvm.io/rvm/install).
+# Make A New Release
 
-Once you've got that installed and configured, get the latest version of Ruby with:
+Please add a new [change log] entry. This helps us track released changes easily.
+
+[change log]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/blob/master/CHANGELOG.md
+
+Then, [tag a new commit] and send it upstream with:
+
+[tag a new commit]: https://git-scm.com/book/en/v2/Git-Basics-Tagging
+[semantic versioning]: http://semver.org/
 
 ```bash
-$ rvm install 2.4.2
+$ COMMIT=$(git rev-parse HEAD)
+$ TAG=6.6.6  # enter your new tag
+$ git tag -a $TAG $COMMIT
+$ git push upstream master --tags
 ```
 
-Select that version and then create an isolated [gemset](https://rvm.io/gemsets/basics) with:
+You can also use the [Gitlab tags UI] for this.
 
-```bash
-$ rvm use 2.4.2
-$ rvm gemset create autonomic
-$ rvm gemset use autonomic
-```
+[Gitlab tags UI]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/tags
 
-Then you can get your Ruby dependencies installed with:
+Our [deploy] CI stage will push the new site to [the production branch].
+
+[deploy]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/blob/d16aec42bd2ddd7449f55d9f06b03499cc660b22/.gitlab-ci.yml#L17
+[the production branch]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/tree/production
+
+Watch the [CI/CD pipeline] to see that it builds successfully.
+
+[CI/CD pipeline]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/pipelines
+
+Then head over to [fullyautomatedluxuryinfrastructure] and run:
+
+[fullyautomatedluxuryinfrastructure]: https://gitlab.com/autonomic-cooperative/fullyautomatedluxuryinfrastructure
 
 ``` bash
-$ gem install jekyll bundler
+$ ansible-playbook orgs/autonomic/gitlabpages.yml
 ```
-
-And serve the website locally with:
-
-``` bash
-$ jekyll serve
-```
-
-You can edit content in the `.md` files under `src` and `src/_posts`.
-
-When you're hacking later on (or in a new shell), you'll need to run:
-
-``` bash
-$ rvm use 2.4.2
-$ rvm gemset use autonomic
-```
-
-And then you'll have access to the environment.

_config.yml

@@ -20,3 +20,7 @@ collections:
     permalink: /blog/:title/
   clients:
     output: false
+exclude:
+  - vendor
+  - Gemfile
+  - Gemfile.lock

bin/deploy

@@ -0,0 +1,26 @@
+#!/bin/bash
+
+GITUSERNAME="autonomicgitlabci"
+GITUSEREMAIL="autonomicgitlabci@nowhere.com"
+DEPLOYSCRIPT="https://github.com/X1011/git-directory-deploy/raw/master/deploy.sh"
+
+export GIT_DEPLOY_DIR="public"
+export GIT_DEPLOY_BRANCH="production"
+export GIT_DEPLOY_REPO="git@gitlab.com:autonomic-cooperative/autonomic-cooperative.gitlab.io.git"
+
+apt-get update -y
+apt-get install -yqq wget openssh-client
+
+wget $DEPLOYSCRIPT && chmod +x deploy.sh
+
+git config --global user.email $GITUSEREMAIL
+git config --global user.name  $GITUSERNAME
+
+mkdir -p ~/.ssh
+eval "$(ssh-agent -s)"
+ssh-add <(echo "$SSH_PRIVATE_KEY")
+echo -e "Host *\n\tStrictHostKeyChecking no\n\n" > ~/.ssh/config
+
+./deploy.sh -m "Git tag: $(git describe --exact-match HEAD)"
+
+rm -Rfv .ssh

src/_includes/contact.html

@@ -3,7 +3,7 @@
   <header class="major">
     <h2>Get in Touch</h2>
     <p>Contact us to discuss your project's needs and arrange a consultation.</p>
-    <p><a href="mailto:autonomic@posteo.net">autonomic@posteo.net</a></p>
+    <p><a href="mailto:autonomic-coop@posteo.net">autonomic-coop@posteo.net</a></p>
     <p>
       If you use encrypted email, here is our <a href="{{ "/assets/pgp/autonomic-key.asc" | relative_url }}">PGP key</a>.
       Our key fingerprint is: <br/><code id="fingerprint">82FC 87C5 1A71 902F DC10 2CF5 4F90 D55B B24B 1147</code>

src/_includes/services.html

@@ -71,7 +71,7 @@
         <p>
           A grounded and principled understanding of the cybersecurity domain can ensure
           your organisation is not liable to any unwanted security threats. We provide
-          structured training.
+          structured training taliored to your threat model.
         </p>
       </li>
     </ul>

src/_posts/2016-09-23-our-founding-principles.md

@@ -1,55 +1,84 @@
 ---
 layout: post
 title: Our Founding Principles
-description: Autonomic Co-operative And Our Core Values.
-image: pic01.jpg
+description: Autonomic Co-operative And Our Core Values
+image: thinkpad.jpg
 category: values
 date: 2017-10-03
 ---
 
-Autonomic is a worker co-operative. That means we are owned and run by our workers and not by bosses or investors. We make our
-decisions collectively using consensus. We are committed to a set of basic principles of working on projects for social
-good. We reject destructive and unsustainable practices within the tech industry.
+Autonomic is a worker co-operative. That means we are owned and run by our
+workers and not by bosses or investors. We make our decisions collectively
+using consensus. We are committed to a set of basic principles of working on
+projects for social good. We reject destructive and unsustainable practices
+within the tech industry.
 
-As individuals, we have become increasingly concerned with the levels of surveillance carried by nation states and corporations.
-Everyone deserves the fundamental right to privacy and safety online as well as in the physical world. We seem to be moving ever
-closer to a total reliance upon centralised services that mine our data for profit and are run in anything but our best interest as
-users.
+As individuals, we have become increasingly concerned with the levels of
+surveillance carried by nation states and corporations.  Everyone deserves the
+fundamental right to privacy and safety online as well as in the physical
+world. We seem to be moving ever closer to a total reliance upon centralised
+services that mine our data for profit and are run in anything but our best
+interest as users.
 
-There is another way. The philosophy of [free software](https://fsfe.org/about/basics/freesoftware.en.html) allows for development guided not by profit alone, but instead by the desires and inspiration of the developers and users. Rather than subjugating users, it aims to empower users by making software source code available for anyone to examine, modify or share. We are committed to building the software commons by making as much of our code available under free software licences as possible.
+There is another way. The philosophy of [free software] allows for development
+guided not by profit alone, but instead by the desires and inspiration of the
+developers and users. Rather than subjugating users, it aims to empower users
+by making software source code available for anyone to examine, modify or
+share. We are committed to building the software commons by making as much of
+our code available under free software licences as possible.
 
-As the internet becomes ubiquitous in our everyday lives, we must consider the technologies that we utilise in order to communicate. We must all have the ability to discuss and collaborate without being spied upon or our personal information sold to the highest bidder. Autonomic are committed to providing a platform for progressive projects and ideas that require accessible and modern infrastructure to thrive and grow, whilst preserving our client's privacy and protecting their data.
+[free software]: https://fsfe.org/about/basics/freesoftware.en.html
+
+As the internet becomes ubiquitous in our everyday lives, we must consider the
+technologies that we utilise in order to communicate. We must all have the
+ability to discuss and collaborate without being spied upon or our personal
+information sold to the highest bidder. Autonomic are committed to providing a
+platform for progressive projects and ideas that require accessible and modern
+infrastructure to thrive and grow, whilst preserving our client's privacy and
+protecting their data.
 
 ## Privacy
 
-We seek to minimise data collection and retention wherever possible. If you don't need it, don't collect it.
+We seek to minimise data collection and retention wherever possible. If you
+don't need it, don't collect it.
 
-We will utilise and recommend encryption wherever possible, especially if it is end to end encryption and has been well tested in
-real life scenarios by non-technical users.
+We will utilise and recommend encryption wherever possible, especially if it is
+end to end encryption and has been well tested in real life scenarios by
+non-technical users.
 
-We believe that unrestricted and uncensored access to the internet is a human right and we should all resist any attempts to censor
-the sharing of knowledge and experiences that helps build greater cooperation between peoples around the world.
+We believe that unrestricted and uncensored access to the internet is a human
+right and we should all resist any attempts to censor the sharing of knowledge
+and experiences that helps build greater cooperation between peoples around the
+world.
 
 ## Transparency
-We don't give you any crap. If something goes wrong, we'll let you know and seek to communicate with our clients and the public in
-an effective manner.
 
-We are committed to using free (as in freedom) software wherever possible and seek to contribute back to the upstream projects we rely on where practical.
+We don't give you any crap. If something goes wrong, we'll let you know and
+seek to communicate with our clients and the public in an effective manner.
 
-We engage in ethical processes to avoid working with any organisations that are racist, homophobic, transphobic, misogynist or otherwise engage in oppressive behaviour.
+We are committed to using free (as in freedom) software wherever possible and
+seek to contribute back to the upstream projects we rely on where practical.
+
+We engage in ethical processes to avoid working with any organisations that are
+racist, homophobic, transphobic, misogynist or otherwise engage in oppressive
+behaviour.
 
 ## Sustainability
-As a worker co-operative, we aim to grow in a sustainable way. This means not taking venture capital or risky loans. We build this the
-smart way, through hard work. We are always learning and studying as we go.
 
-We are committed to learning more about about the ecological impact of technology. Whether that be the energy used by data centres
-or the components in our computing devices.
+As a worker co-operative, we aim to grow in a sustainable way. This means not
+taking venture capital or risky loans. We build this the smart way, through
+hard work. We are always learning and studying as we go.
 
-We will engage with the wider co-operative movement and work together to grow our sector and begin to build a new world in the ashes
-of the old.
+We are committed to learning more about about the ecological impact of
+technology. Whether that be the energy used by data centres or the components
+in our computing devices.
+
+We will engage with the wider co-operative movement and work together to grow
+our sector and begin to build a new world in the ashes of the old.
 
 <hr>
 
-We hope this basic statement of principles has given you an idea of where we are coming from and perhaps where we will be heading. The plan
-is to revisit these ideas as we grow and access the impact of this project. We hope you will be a part of this adventure.
-
+We hope this basic statement of principles has given you an idea of where we
+are coming from and perhaps where we will be heading. The plan is to revisit
+these ideas as we grow and access the impact of this project. We hope you will
+be a part of this adventure.

src/_posts/2018-01-11-spectre-and-meltdown.md

@@ -0,0 +1,150 @@
+---
+layout: post
+title: Spectre and Meltdown
+description: A Spectre Is Haunting Our Processors...
+image: spectre.jpg
+category: values
+date: 2018-01-11
+---
+
+Autonomic have now completed the process of applying patches to to all
+of our servers in response to the so called Spectre and Meltdown 
+vulnerabilities. Our upstream providers have also confirmed that they have
+patched their infrastructure. We will monitor the situation as it develops.
+
+We are currently super busy with clients so we decided to repost the
+excellent security bulletin from our friends over at [Rise Up](https://riseup.net/) 
+which goes into detail oh how to update various operating systems. All credit
+to them for the rest of this blog post.
+
+## The Facts
+
+As you have probably read, there are three related security problems in
+contemporary CPUs. These vulnerabilities open the potential for a
+nefarious program to steal passwords, secrets, and personal information
+from you computer, even if the program is just Javascript loaded from a
+web site you visit. These vulnerabilities are as serious as they sound,
+and you should take action to upgrade your software. 
+
+* The first flaw, called "Meltdown," affects nearly all Intel CPUs and
+has been fixed with updates to most operating systems. 
+
+* The two other flaws, called "Spectre," apply to nearly all CPUs built
+in the last 20 years, not just Intel, although they are more difficult
+to exploit. There are no permanent fixes for Spectre available at this
+time, although if you update your software you will make these attacks
+much less likely. 
+
+You should take *both* these steps now, for all your devices: 
+
+* Upgrade your web browser (see below). These fixes make the new
+attacks against CPUs more much difficult. 
+
+* Upgrade your operating system. There are updates available for
+Windows, macOS, and GNU/Linux that fix the Meltdown vulnerability for
+Intel CPUs and provide some mitigations for Spectre. Additionally, new
+releases of iOS and Android have mitigations for Spectre.
+
+Better fixes will continue to arrive in the next weeks/months for your
+operating system and software. Please keep your system up to date! 
+
+## Browsers 
+By updating your browser, you can make it significantly harder for an
+attacker to steal secrets off your computer using Javascript loaded from
+a web site you visit. 
+
+Firefox version 57.0.4 and later [includes mitigation measures](https://www.mozilla.org/en-US/security/advisories/mfsa2018-01/) 
+against Spectre attack. 
+
+Edge has been updated to include Spectre migitations. When you apply the
+latest Windows update, you will get the new version of Edge. 
+
+Safari will be updated very soon, according to Apple. Check the App
+Store updates. 
+
+Chrome will include Spectre mitigations starting with version 64, to be
+released Jan 23. In the mean time, you can change your configuration to
+greatly mitigate [against the Spectre vulnerability by enabling](https://support.google.com/chrome/answer/7623121?hl=en)
+ "site isolation."
+
+Additionally, please see [Rise Up's better browsing guide](https://riseup.net/en/better-web-browsing) for
+instructions on best practices for securing your web experience (which
+will also help mitigate against these new attacks). 
+
+## Windows 
+For Windows 10, you must first upgrade any anti-virus software before
+upgrading Windows. [Failure to do so may make your computer stop working](http://www.theregister.co.uk/2018/01/04/microsoft_windows_patch_meltdown/).
+
+To upgrade Windows 10: 
+
+```
+Select the Start button, and then go to Settings > Update & security > Windows Update, and select Check for updates. 
+```
+
+Now is a good time to enable automatic updates: 
+
+```
+Select the "Start" button, then select "Settings" > "Update & security" > "Windows Update" > "Advanced options" 
+and then under "Choose how updates are installed", select "Automatic (recommended)". 
+```
+
+If you are running Windows 7 or 8, an update is also available. 
+
+## macOS 
+If you already have macOS version 10.13.2 then you are [protected against Meltdown](https://support.apple.com/en-us/HT208394). 
+Otherwise, to upgrade macOS: 
+
+```
+Open the App Store app on your Mac. Click "Updates" in the App Store toolbar, then use the "Update" buttons 
+to download and install any updates listed.
+```
+
+Now is a good time to check enable automatic updates: 
+
+```
+Select the Apple menu, then select "System Preferences" > "App Store" > "Automatically check for updates". 
+```
+
+Apple plans to soon release an update to Safari browser to provide some
+mitigation against Spectre. 
+
+## iOS
+Apple has said that iOS is affected by Spectre, and an update to
+mitigate against most of the new attacks has been released. If you have
+iOS version 11.2 or later, [then you are good](https://support.apple.com/en-us/HT208394). 
+
+To check for new updates, go to `Settings > General > Software Update.` 
+
+## Android 
+The bad news is that Android is vulnerable to Spectre and unless you
+have a Google-branded phone or run a custom firmware you might not get
+an update for months, if ever. However, the consensus among security
+researchers at the moment is that the Spectre attack is difficult enough
+that there are probably easier ways to compromise an Android device.
+Yeah? 
+
+There is one thing you can do now to make your Android device more safe
+against these new CPU attacks: 
+
+* Turn on ["site isolation" in Chrome](https://support.google.com/chrome/answer/7623121?hl=en)
+* Upgrade Chrome Browser after Jan 23. 
+* Alternately, use Firefox for Android. 
+
+## Debian/Ubuntu GNU/Linux 
+Run "Software Center" or "Software Updater." 
+
+Alternately, open a terminal and type: 
+
+```
+sudo apt update 
+sudo apt upgrade 
+sudo reboot 
+```
+
+## Fedora GNU/Linux 
+Open a terminal and type: 
+
+```
+sudo dnf --refresh update kernel 
+sudo reboot 
+```