Pick a README.md template for app repositories for consistency #31

Closed
opened 2020-10-26 08:02:24 +00:00 by decentral1se · 5 comments
Owner

Like YunoHost app repositories, when you see the README, it gives you a run down of what is going on. We could skip this and instead just put documentation for apps on https://docs.cloud.autonomic.zone but either way, we should settle on a README template for consistency even if it is 2 lines, I guess. I don't want to make much more work for ourselves but it would be good to have something for this. For reference: https://github.com/YunoHost-Apps/nextcloud_ynh

Like YunoHost app repositories, when you see the README, it gives you a run down of what is going on. We could skip this and instead just put documentation for apps on https://docs.cloud.autonomic.zone but either way, we should settle on a README template for consistency even if it is 2 lines, I guess. I don't want to make much more work for ourselves but it would be good to have something for this. For reference: https://github.com/YunoHost-Apps/nextcloud_ynh
Owner

Agreed! I had made a start here: https://git.autonomic.zone/coop-cloud/example

Possible additions:

  • Upstream image (name + link)
  • Link to Coop Cloud docs
Agreed! I had made a start here: https://git.autonomic.zone/coop-cloud/example Possible additions: - Upstream image (name + link) - Link to Coop Cloud docs
decentral1se added this to the Public mini-launch milestone 2020-10-27 08:04:48 +00:00
decentral1se added the
design
label 2020-10-27 08:09:14 +00:00
decentral1se added this to the (deleted) project 2020-12-27 11:48:46 +00:00
decentral1se removed this from the Public mini-launch milestone 2021-03-02 09:14:57 +00:00
Owner

I'd like to get this done so that we can compile the app catalogue automagically based on the READMEs. I think that means that READMEs should contain:

  • App name
  • Category (apps / dev / util / ☠)
  • Link to upstream repo
  • Overall status score
  • Link to upstream image
  • Image score
  • Healthcheck Y/N
  • Backups score
  • Email score
  • CI score
I'd like to get this done so that we can compile the [app catalogue](https://cloud.autonomic.zone/apps/) automagically based on the READMEs. I think that means that READMEs should contain: - App name - Category (apps / dev / util / ☠) - Link to upstream repo - Overall status score - Link to upstream image - Image score - Healthcheck Y/N - Backups score - Email score - CI score
Author
Owner

I'd like to get this done so that we can compile the app catalogue automagically based on the READMEs.

🤯

Go go go go go go go

> I'd like to get this done so that we can compile the app catalogue automagically based on the READMEs. 🤯 Go go go go go go go
Owner

@decentral1se how's this look?

image

@decentral1se how's this look? ![image](/attachments/1ae6078b-2298-47bb-8b48-e956985311f7)
decentral1se added this to the Beta release milestone 2021-03-02 12:20:34 +00:00
Owner

All apps updated, declaring this done.

All apps updated, declaring this done.
This repo is archived. You cannot comment on issues.
No description provided.