Hi Jed and everyone,
First, thank you Jed for the huge effort you have done already with this!
I was also thinking that keeping track of every new plugin is too much
work for a single person. On the other hand, I'm pretty sure the fact
that such a listing exists is very valuable to many tiddlywikians.
However I'm not sure about asking authors to fill the info for their
plugins. This is why I'd like to start a discussion here, including
plugins users who are less likely to participate in a technical
discussion on github. I'd really like to have users opinion about
what/how they would like to find in an "unofficial" list of plugins.
The question of finding a workflow which works without too much strain
on plugin authors or on the person who manage the central listing is
already being discussed on github
<https://github.com/Jermolene/TiddlyWiki5/issues/1696> for the official
TW plugin library. The question is a bit different for the
CommunitySearch listing
<http://erwanm.github.io/tw-community-search/#CommunityPlugins> (since
there is no need to be as strict about the quality/safety level), but
the two are certainly related. I don't have very clear ideas on the
topic, but hopefully we can put our brains together to improve the
workflow, in a way which would be satisfactory for everyone.
I'd like to start by explaining how the process currently works on the
CommunitySearch (more detail in the documentation
<http://erwanm.github.io/tw-community-search/#PluginsCollection>)
1) the aggregator extracts information from every actual plugin it finds
on the wikis. This gives a pretty large list, but there is no way to
tell (1) if a plugin originates from the wiki where it was found or if
it was simply installed there (so there are duplicates); (2) if a plugin
is usable or not (it could be obsolete, unfinished, just a test...).
2) This is why the process relies on matching the raw plugins against
Jed's manual listing: this way we obtain the original wiki address, and
of course this step discards plugins which are not listed in Jed's
curated list. Another important addition from Jed's list is the
category, which becomes more and more important for a user to find what
they are looking for as more plugins are developed. Currently, the only
advantage of the aggregator collection is for Jed (or any other list
manager!), who can find addiotnal plugins to include to the listing more
easily.
In the current version, I think the potential of the aggregator for
automation is underused:
- the amount of manual input for each plugin could be reduced, because
plugins already contain fields for author, description and version (I
haven't checked recently, but as far as I remember these 3 fields are
filled in like 99% of the cases). Basically, from the CommunitySearch
point of view, the only additional info we need are the origin wiki and
the category (as well as the plugin name, of course).
- I plan to use the plugin library mechanism for official plugins, and
possibly other authors libraries. I haven't studied this in detail yet,
but from a quick look it seems possible to include plugins from there
without any manual addition (except for the category, but this is optional).
For the unavoidable manual part:
- I tend to think that if a plugin has been announced on the group, and
people tested it and gave positive feedback, it can be trusted enough to
be included in the CommunitySearch list.
- I'm thinking that maybe I could provide explanations and a template so
that anyone with a github account could add a plugin to the "skeleton"
wiki
<https://github.com/erwanm/tw-community-search/tree/master/skeleton/tiddlers>
with a pull request, in the same way as we can add documentation to
tiddlywiki.com.
Finally, I don't follow closely the discussion about the TW official
library, but maybe there is also a way to connect the two processes? It
seems to make sense to me that a plugin starts "its career" in the
CommunitySearch listing, is used a while and hopefully receives feedback
from users, until it is deemed ready to be included in the official library?
Any idea/opinion welcome!
Regards
Erwan
On 18/11/15 13:22, Jed Carty wrote:
I am very far behind on adding and updating plugins to the plugin
listing on inmysocks.tiddlyspot.com
<http://inmysocks.tiddlyspot.com/#Plugin%20twCard>, which is a problem
because there have been a bunch of good plugins released recently. I
am about to start a new job and am probably not going to have time to
catch up or get any better in the foreseeable future. So, in order to
maintain a useful community plugin listing I could use some help from
plugin authors. If you have a plugin that you would like listed in the
community search you need to 1st have your wiki listed in the
community search
<http://erwanm.github.io/tw-community-search/#AuthorDocumentation>,
then go to the tool for creating the plugin twCards
<http://inmysocks.tiddlyspot.com/#Plugin%20twCard> (under the Make
Plugin twCard tab) and enter the information for your plugin and click
on the 'Create Plugin twCard' button at the bottom and then import the
tiddler created into your wiki and let me know
<http://inmysocks.tiddlyspot.com/#Jed%20Carty%20%28inmysocks%29>. Then
I can just import that from your wiki to add or update the information
for your plugin. If you release a new version than you can just update
the revision field and let me know.
For the moment the only important fields to include in addition to the
plugin name are: name, category, revision, date, maintainer,
short_description, wiki and plugin_tiddler.
Of course no one has to do this, but it will help get an accurate
listing on the community search and help people find your plugins.
--
You received this message because you are subscribed to the Google
Groups "TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send
an email to tiddlywiki+unsubscr...@googlegroups.com
<mailto:tiddlywiki+unsubscr...@googlegroups.com>.
To post to this group, send email to tiddlywiki@googlegroups.com
<mailto:tiddlywiki@googlegroups.com>.
Visit this group at http://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit
https://groups.google.com/d/msgid/tiddlywiki/efdc692e-60ab-4fe4-8a8d-68a75538aa59%40googlegroups.com
<https://groups.google.com/d/msgid/tiddlywiki/efdc692e-60ab-4fe4-8a8d-68a75538aa59%40googlegroups.com?utm_medium=email&utm_source=footer>.
For more options, visit https://groups.google.com/d/optout.
--
You received this message because you are subscribed to the Google Groups
"TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to tiddlywiki+unsubscr...@googlegroups.com.
To post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at http://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit
https://groups.google.com/d/msgid/tiddlywiki/564CD8A9.3050707%40gmail.com.
For more options, visit https://groups.google.com/d/optout.