Open APIs

Hi

Can someone please help with the process of deprecating APIs and where do we capture the information that a certain API is deprecated?
For instance, I recall a discussion on deprecating TMF636 however, if I search for TMF636, I'm able to access the API and also download the API documentation which says 'Production'. However, it's not available in any of the API tables: 'Early Adoption (Beta)', 'Historic', 'Previous (N-2)' or 'Archived Comments'.

Same for TMF658, it's only available under 'Historic' options. It's not very clear if this API has been deprecated or not.
Can someone please help in identifying the deprecated APIs? Also, I think probably the Open API table itself should be modified to include the deprecated APIs (may be at the bottom of table or a separate table in same page).

Regards

------------------------------
Mukesh Kumar
Oracle Corporation
------------------------------

Hi Mukesh

Thanks for highlighting this issue.  This is what should happen (although as you have noticed it is not happening properly today):

• Deprecated APIs should be moved from the Production Table to the Historic Table and marked as Deprecated in the Notes column (to distinguish them from Superseded APIs that have a newer version in the Production Table). 
• They should also be marked as Archived in the resource library, with a note on the download page that the API has been Deprecated (this has now been done for TMF636).

We'll work on fixing this for the existing APIs and improving the process so it's clear in future.

Andy

------------------------------
Andy Tiller
TM Forum
------------------------------

Original Message:
Sent: Nov 02, 2022 03:46
From: Mukesh Kumar
Subject: Deprecated APIs

Hi

Can someone please help with the process of deprecating APIs and where do we capture the information that a certain API is deprecated?
For instance, I recall a discussion on deprecating TMF636 however, if I search for TMF636, I'm able to access the API and also download the API documentation which says 'Production'. However, it's not available in any of the API tables: 'Early Adoption (Beta)', 'Historic', 'Previous (N-2)' or 'Archived Comments'.

Same for TMF658, it's only available under 'Historic' options. It's not very clear if this API has been deprecated or not.
Can someone please help in identifying the deprecated APIs? Also, I think probably the Open API table itself should be modified to include the deprecated APIs (may be at the bottom of table or a separate table in same page).

Regards

------------------------------
Mukesh Kumar
Oracle Corporation
------------------------------

Hi @Andy Tiller

Thank you for the response.
Also, thank you for taking this up. This would be really helpful.

Regards
​

------------------------------
Mukesh Kumar
Oracle Corporation
------------------------------

Original Message:
Sent: Nov 04, 2022 13:49
From: Andy Tiller
Subject: Deprecated APIs

Hi Mukesh

Thanks for highlighting this issue.  This is what should happen (although as you have noticed it is not happening properly today):

• Deprecated APIs should be moved from the Production Table to the Historic Table and marked as Deprecated in the Notes column (to distinguish them from Superseded APIs that have a newer version in the Production Table). 
• They should also be marked as Archived in the resource library, with a note on the download page that the API has been Deprecated (this has now been done for TMF636).

We'll work on fixing this for the existing APIs and improving the process so it's clear in future.

Andy

------------------------------
Andy Tiller
TM Forum

Original Message:
Sent: Nov 02, 2022 03:46
From: Mukesh Kumar
Subject: Deprecated APIs

Hi

Can someone please help with the process of deprecating APIs and where do we capture the information that a certain API is deprecated?
For instance, I recall a discussion on deprecating TMF636 however, if I search for TMF636, I'm able to access the API and also download the API documentation which says 'Production'. However, it's not available in any of the API tables: 'Early Adoption (Beta)', 'Historic', 'Previous (N-2)' or 'Archived Comments'.

Same for TMF658, it's only available under 'Historic' options. It's not very clear if this API has been deprecated or not.
Can someone please help in identifying the deprecated APIs? Also, I think probably the Open API table itself should be modified to include the deprecated APIs (may be at the bottom of table or a separate table in same page).

Regards

------------------------------
Mukesh Kumar
Oracle Corporation
------------------------------