Community website COVID-19 notificatieapp

The community website is an entry point for the community of people that are interested in learning more about the notification app and that may be willing to help out.

About

• Slack channel for this website: #notificatie-app-community-website (join via Code for NL)
• Website (beta): View the current community website on Github.io

Goals:

These goals are maintained by the community manager of the Ministry of Health. Suggestions are welcome, as ever.

• Offer the community some overview
• Improve the onboarding for new community members (also for non-techies, see below)
• Landing page for Github, Trello, Slack etc. Point out the main features of the community
• Give props to the most active community members
• A showcase page for the openness of the project, that will hopefully inspire other government projects to be more open too
• Set the right atmosphere and expectations for people that want to help out
• Make it clear that this is partly a community driven project. Everyone is allowed to contribute, criticize, etc.

Target audience

(Potential) community members. Specifically:

• Programmers
• Designers
• Community managers
• Communication experts Over time, we hope to engage a broader group of people, that can also help with promoting the app

Look and feel

• We are building this app in collaboration with the people in NL.
• Does not have to be super tidy, a little messyness wil perhaps lower the entry barrier.
• Friendly and welcoming
• Simple language
• Easy to use for a broad range of people, not just the die hards. Do not assume that people will know what Github, Slack, etc is. Although the die-hards are probably the biggest audience, we do not want to scare away others :-).

To do

• Move this to do list to a Github project board
• Translation of content into English
• Find a project maintainer
• User test the webpage, make modifications to make sure the website is understandable for a broader audience.

How is this project set up?

What is GitHub Pages

GitHub Pages are public webpages hosted directly through the GitHub repository.

What is Jekyll

GitHub Pages support the static site generator Jekyll. Jekyll supports Markdown, Liquid, HTML and CSS to create a complete static website. By using the Liquid templating language, content can be stored in Markdown.

Editing content

Content can be edited via pull requests via the blocks folder in this repository.

How to add a block

To add a block, create a Markdown file in _blocks with the following template:

---
lang: en
index: 7
title: The title
subtitle: Subtitle
list:
  - title: Example
    href: https://example.com
    text: Some example website listing
  - title: Another example
    href: https://www.example.com
    text: Another example
button:
  text: Goto Github
  icon: github
  href: https://github.com/
---
The Markdown content goes here, this can contain <code>HTML</code>.

Please give your file a short English name without spaces (you can use dash - instead). You should at least provide the base file with lang: nl. The translations should have the same name with a -lang suffix, where lang is the language keyword e.g. en.

How to test GitHub Pages locally

To build Jekyll, you could install Jekyll locally or probably the easier route: use a Docker image. To use a Docker image you should have Docker engine installed, see how to install Docker enginge.

starefossen/github-pages is a small Alpine Docker image for running GitHub Pages / Jekyll projects locally. You only need to mount the pages in a volume under /usr/src/app like this:

docker run -it --rm -v "$PWD":/usr/src/app -p "4000:4000" starefossen/github-pages

Note: for Windows users we advise Powershell or another shell that supports $PWD, for cmd you can replace $PWD with %cd%.

The Jekyll page will be available on http://localhost:4000.