Uploaded image for project: 'AriaTosca'
  1. AriaTosca
  2. ARIA-382

README missing items

    XMLWordPrintableJSON

Details

    • Task
    • Status: Open
    • Minor
    • Resolution: Unresolved
    • None
    • None
    • None
    • None

    Description

      A bunch of items that should be added to the README:

      • The current "getting started" example is only relevant to Linux (and macOS?) - This should be noted, so Windows users don't try to run it.
      • Add a link to API docs
      • Add a link to an official Apache mirror for source code download; Also add a short explanation on how to test signatures, or at least link here
      • Add instructions on how to run RAT checks
      • Clarify installation instructions where it comes to installing via PyPI vs via Source - This seemed to have already confused some people
      • Consider adding a section explaining about how to use Cloudify plugins, linking to the Cloudify's plugin adapter
      • Note that the requirements.txt file is not used by pip by default during installation (from source or from sdist), and therefore, during installation, various (yet constrained) versions of dependencies may be installed - and not necessarily the ones that were tested prior to release. Users may install using requirements.txt explicitly, and be guaranteed the exact versions for dependencies that were tested prior to release.

      Attachments

        Activity

          People

            Unassigned Unassigned
            ran Ran Ziv
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated: