Uploaded image for project: 'Apache Cordova'
  1. Apache Cordova
  2. CB-5658

Move plugin docs to plugin repos

    XMLWordPrintableJSON

Description

    This involves:

    1. Delete the docs/ directory from all plugins

    • They contain stale copies of what's in cordova-docs

    2. Move plugin information found in cordova-docs into a single doc/index.md file within the respective plugin repos

    • Link to this file within each plugin's README.md file

    3. Delete the "API Reference" section of cordova-docs

    4. Add a guide called "Cordova Plugins", which contains:

    • a link to plugins.cordova.io,
    • a list of the org.apache.cordova plugins, which link to their index.md files on github
    • e.g. https://github.com/apache/cordova-plugin-media-capture/blob/master/README.md
    • These can be changed to point at their plugins.cordova.io page when that shows READMEs.
    • A link to the 3.3 docs, which still have plugin API reference
    • Mostly, this is for finding non-english versions.

    Motivation:

    • Plugins are on a separate release cycle from platforms & docs.
    • The documentation is often mismatched due to this
    • Pull requests for plugins don't update the plugin docs
    • But I think they would if the docs were in the same repo

    Caveats:

    • This will mess up our current translations story for plugins.
    • I think this can be fixed up though, by changing out http://crowdin.net push / pull scripts
    • E.g. have README.md translations go in: cordova-plugin-foo/translations/fr/README.md

    Attachments

      Activity

        People

          agrieve Andrew Grieve
          agrieve Andrew Grieve
          Votes:
          0 Vote for this issue
          Watchers:
          5 Start watching this issue

          Dates

            Created:
            Updated:
            Resolved: