Giter VIP home page Giter VIP logo

edgex-snap-metadata's Introduction

edgex-snap-metadata

This repo contains the metadata of EdgeX snaps along with utility scripts to generate appstream metadata files.

The output files along with the EdgeX snaps icon are stored in the appstream branch.

Metadata

The metadata directory contains the metadata of snaps.

Each .md file contains the summary and description, separated by a markdown horizontal line (---):

summary
---
description

Notes on the formatting:

  • Use **bold** for section header
  • Section headers do not need a trailing colon
  • Use double-spaces at the end of a line to make a line-break Appstream parser removes whitespaces.
  • Use two line breaks to start a new paragraph in text or after the section headers
  • URLs get converted to hyperlinks automatically. Adding hyperlinks as [title](url) work on Github and in the snapcraft.io preview but will not be rendered on the final snapcraft.io listing!

Usage

Generate AppStream file from markdown:

go run generate-appstream.go --input=metadata/edgex-device-gpio.md

CI

Markdown files in main get converted automatically and added to the appstream branch.

See .github/workflows/appstream.yaml

edgex-snap-metadata's People

Contributors

farshidtz avatar monicaisher avatar

Watchers

 avatar  avatar  avatar

edgex-snap-metadata's Issues

Migrate snap metadata to a central repository

The metadata kept in snapcraft.yaml is automatically uploaded to store upon the initial publication. Follow-up changes to that metadata which are not explicitly uploaded (using snapcraft upload-metadata --force) may diverge from what is manually set on the store. In most cases, the metadata in snapcraft.yaml have already diverged from those on the store.

In addition to the problem of diverged metadata copies, removing the information from the yaml file has the following benefits:

  • simplifies docs maintenance
  • reduces the size of the yaml file: some descriptions are very long
  • simpler and less error-prone formatting: free text, indentations, and minimal markdown syntax won't be mixed into YAML
  • allows central quality control of metadata that immediately appear in store

The ground truth metadata will be maintained here in this repo: https://github.com/canonical/edgex-snap-metadata


Checklist:

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.