odpi / egeria-docs

Documentation repository for the Egeria project.
https://egeria-project.org
Other
22 stars 30 forks source link

Component status for view services out of sync with code - likely docs error #444

Open planetf1 opened 2 years ago

planetf1 commented 2 years ago

In the below example, the view services we currently advise people to use are reported as technical preview, which I believe is correct.

However the docs page for these (dino, tex, rex) reports the components as in-development - this should be updated


Retrieving the registered view services ...
GET https://lab-datalake:9443/open-metadata/platform-services/users/garygeeke/server-platform/registered-services/view-services
Response: 
{
    "class": "RegisteredOMAGServicesResponse",
    "relatedHTTPCode": 200,
    "services": [
        {
            "serviceId": 800,
            "serviceName": "Glossary Author OMVS",
            "serviceDevelopmentStatus": "IN_DEVELOPMENT",
            "serviceURLMarker": "glossary-author",
            "serviceDescription": "View Service for glossary authoring.",
            "serviceWiki": "https://egeria-project.org/services/omvs/glossary-author/overview"
        },
        {
            "serviceId": 803,
            "serviceName": "Dynamic Infrastructure and Operations OMVS",
            "serviceDevelopmentStatus": "TECHNICAL_PREVIEW",
            "serviceURLMarker": "dino",
            "serviceDescription": "Explore and operate an open metadata ecosystem.",
            "serviceWiki": "https://egeria-project.org/services/omvs/dino/overview"
        },
        {
            "serviceId": 801,
            "serviceName": "Repository Explorer OMVS",
            "serviceDevelopmentStatus": "TECHNICAL_PREVIEW",
            "serviceURLMarker": "rex",
            "serviceDescription": "Explore open metadata instances.",
            "serviceWiki": "https://egeria-project.org/services/omvs/rex/overview"
        },
        {
            "serviceId": 802,
            "serviceName": "Type Explorer OMVS",
            "serviceDevelopmentStatus": "TECHNICAL_PREVIEW",
            "serviceURLMarker": "tex",
            "serviceDescription": "Explore the open metadata types in a repository or cohort.",
            "serviceWiki": "https://egeria-project.org/services/omvs/tex/overview"
        },
        {
            "serviceId": 804,
            "serviceName": "Server Author OMVS",
            "serviceDevelopmentStatus": "IN_DEVELOPMENT",
            "serviceURLMarker": "server-author",
            "serviceDescription": "Author servers.",
            "serviceWiki": "https://egeria-project.org/services/omvs/server-author/overview/"
        }
    ]
}
planetf1 commented 2 years ago

CTS is missing a status bar (ie stable)

        {
            "serviceId": 191,
            "serviceName": "Conformance Suite Services",
            "serviceDevelopmentStatus": "STABLE",
            "serviceURLMarker": "conformance-suite",
            "serviceDescription": "Run automated open metadata conformance suite services",
            "serviceWiki": "https://egeria-project.org/guides/cts/overview/"
        },