Hyperion-Android icon indicating copy to clipboard operation
Hyperion-Android copied to clipboard

How about a little readme in each plugin's directory?

Open Aditya94A opened this issue 7 years ago • 8 comments

To easily convey what the plugin does, what it looks like etc. Or maybe some wiki pages? Or both?

Aditya94A avatar Apr 13 '18 08:04 Aditya94A

How does everyone feel about this going in the main README.md? I'm concerned that having separate READMEs for the plugins might make it hard to quickly look up what they do.

nishtahir avatar Apr 16 '18 21:04 nishtahir

I'm not a fan of mile-long readme files personally. Additionally, some plugins may require quite a bit of explanation while others may require little more than a paragraph making formatting of a large number of plugins on the same page a little unbalanced.

ToxicBakery avatar Apr 16 '18 21:04 ToxicBakery

How about something like a table of contents on the main README that links to more elaborate READMEs in their respective folders?

nishtahir avatar Apr 16 '18 21:04 nishtahir

That would make more sense. Have the main README outline the project, build steps etc. A links to individual plugin wikis can be listed

kvithayathil avatar Apr 16 '18 21:04 kvithayathil

How about something like a table of contents on the main README that links to more elaborate READMEs in their respective folders?

That's what I thought this was suggesting :laughing:

ToxicBakery avatar Apr 16 '18 21:04 ToxicBakery

Any updates on this?

The README is currently just asking us to add a bunch of dependencies without any indication whatsoever as to what they actually do.

Does geiger counter make my app magically detect alpha particles?

How about putting a small description anywhere temporarily (like just a list below #Usage) and then move them to wherever (individual READMEs in each folder or wiki or whatever) when we settle on it.

Aditya94A avatar May 16 '18 08:05 Aditya94A

https://github.com/willowtreeapps/Hyperion-Android#third-party-plugins-1

A Third Party Plugins section was added. However, Geiger Counter has not been added to the list yet!

Maybe we could move the list of Third Party Plugins higher up in the README for visibility? Perhaps in the same section as https://github.com/willowtreeapps/Hyperion-Android#third-party-plugins

As of now, we have two Third Party Plugins sections. PR incoming

mrk-han avatar May 16 '18 11:05 mrk-han

Ahh, I see... it seems we may want to actually add a section which describes every plugin available, and not just the descriptions of the Third Party Plugins.

mrk-han avatar May 16 '18 12:05 mrk-han