Page metadata to customize it

[peterdesmet]

Pages can now be customized somewhat, to make them more digestible and pleasant to read. This can be done by defining a cover image, an introduction paragraph and a "learn more" link in the page metadata. None of these are mandatory (and the order doesn't matter):

title: Biodiversity data quality
cover_image: gene-pensiero-332842.jpg
cover_image_by: Gene Pensiero
cover_image_ref: https://unsplash.com/photos/PlkN_pN2ryc
intro: The goal of this interest group is to discuss, determine, formalize and standardize concepts, problems, policies, metadata, methodologies and mechanisms related to biodiversity data quality, collaboratively and incrementally, and to promote associated best practices throughout the biodiversity informatics community.
learn_more: https://github.com/tdwg/bdq

## Rationale

Data quality is a major concern in biodiversity informatics. The distributed nature of data acquisition and digitization, the specific difficulties imposed by some of the data sub-domains, such ...

Which renders like this:

When nothing except the title is defined, it renders like this:

Feedback

Before I start documenting this, I'd like some feedback if those metadata attributes are sufficient and intuitive?

Cover image

• cover_image: a URL or image file in the static/cover_images directory (preferred to avoid broken images)
• cover_image_by: name of person who took the photo
• cover_image_ref: a URL to where more info regarding the image and its licensing can be found. Did not want to use cover_image_url as that might be interpreted as the URL of the image file itself.

Introduction

• intro: A one or two sentence introduction about this page. My first implementation was to do this by default for the first paragraph/sentence of the content, but doing so automatically for all pages could lead to undesired effects. Adding it as a metadata attribute allows more control (to add it or not), but does not allow to include markdown (like links or bold), but that's maybe OK.

Learn more

• learn_more: a URL to a page where more information can be found, for example the GitHub repository of the IG or standard. Not sure about the phrase "learn more", but I think it's good to have a call to action quite high up the page to direct people to where the actual content is.

[dkoureas]

I think is important to also show the level of activity of the groups. I understand that this can be assessed by through GitHub activity, but it would be great to also have an attribute that would point to the list of Group reports by the conveners.

This would also increase accountability of conveners to actually produce these annual reports. The reports can go into their github pages and linked to the website.