Language aside, the support for plugins/agents is laughable at best. The documentation linked to in this thread has a date of May 25, 2011. It has many sections that do not have document links or have TODO tags still. It is not structured in a way that is at all adequate for documentation. All I have been trying to do is update the Discogs agent, and the sheer amount of ObjectContainers and other arbitrary methods outlined in the documentation with no design flow or examples given makes the documentation obscenely difficult to sort through. I as well as many others are not willing to sift through it all only to find that the seven year old documentation results in a non-working plugin.
Plex users, especially Plex Pass users, care about this platform, and given the fact that many of these same users are willing to contribute to the platform without compensation of any form, the least Plex can do is provide documentation. There is no excuse that Plex could provide for this support not being there. They have users actively willing to make their platform better; but cannot seem to provide up to date documentation free of work in progress tags and other mistakes. If we are not going to get up to date documentation, can we at least get a ReadTheDocs page, or something that is not a PDF so we can actually search through this mountain of info?
As a side note to any Plex employee who may happen across this, I’d like to offer to help rewrite the documentation. I’m Software Engineering student, with more than enough free time outside of work during these summer months. Hell, I’ll do it just because I want to see something concrete with Plex’s name on it. No more out of date, community-sourced guides, but an actual company-sponsored documentation. I realize this is a long-shot, but hey.
Despite the novel above, I really enjoy this platform. I would like to see it continue to improve and expand. I feel like actual documentation for these features would help take some of the load off of the actual developers by allowing users to actually provide working plugins finally. Either way, Plex needs to either commit or publicly drop their support for user-created plugins, because this is ridiculous.
