Uploaded image for project: 'Camel'
  1. Camel
  2. CAMEL-14934

Improve Component, Language, Data format, etc. descriptions in Camel Catalog

Attach filesAttach ScreenshotVotersWatch issueWatchersCreate sub-taskLinkCloneUpdate Comment AuthorReplace String in CommentUpdate Comment VisibilityDelete Comments
    XMLWordPrintableJSON

Details

    • New Feature
    • Status: Resolved
    • Major
    • Resolution: Fixed
    • None
    • 3.3.0
    • None
    • None
    • Unknown

    Description

      The descriptions of components, languages, data formats, etc. in Camel catalog currently use several inconsistent styles. As agreed on camel-dev https://www.mail-archive.com/dev@camel.apache.org/msg50591.html we should try to stick to a common style characterized by the following rules:

      Shorter is better. Less/shorter words are faster to read and faster to understand
      (ii) An application of : Leave out words and information available elsewhere in the Catalog record. Esp. do not repeat the title and kind (component, language, ...) because they are clear from the context. The same holds for the word "Camel".
      (iii) Concentrate on functionality (what it does), because that's what most users want to know; preferably start with a verb in the plain (imperative) form

      Example:

      old: JacksonXML data format is used for unmarshal a XML payload to POJO or to marshal POJO back to XML payload.

      new: Unmarshal an XML payload to POJO or marshal a POJO back to XML.

      Attachments

        Activity

          This comment will be Viewable by All Users Viewable by All Users
          Cancel

          People

            ppalaga Peter Palaga
            ppalaga Peter Palaga
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Slack

                Issue deployment