Node: [docs] Domain API is depreciated in v12 docs
Since the domain API is depreciated, may I suggest moving the documentation to the Depreciated API section and if you need to point users to the page with this change, you can provide a link to the depreciated docs link at the Domain page.
Any thoughts?
ahtee
All 3 comments
@nodejs/documentation
Trott
on 9 Aug 2019
Have we ever moved API docs to deprecated.html? I don't see anything comparable in it to what I think is being proposed here.
Moving them seems not so useful to me. They make them harder to find, and would overwhelm the https://nodejs.org/dist/latest-v12.x/docs/api/deprecations.html page, making that page harder to navigate. I don't see a problem with the current layout, the domain docs are pretty clear about why they are deprecated, as well as pretty clear that the API will remain for the forseeable future.
sam-github
on 10 Aug 2019
Thank you, was just wanting to ask
ahtee
on 20 Aug 2019
Related issues
filipesilvaa
路
3Comments
cong88
路
3Comments
willnwhite
路
3Comments
jmichae3
路
3Comments
danialkhansari
路
3Comments
Most helpful comment
Have we ever moved API docs to deprecated.html? I don't see anything comparable in it to what I think is being proposed here.
Moving them seems not so useful to me. They make them harder to find, and would overwhelm the https://nodejs.org/dist/latest-v12.x/docs/api/deprecations.html page, making that page harder to navigate. I don't see a problem with the current layout, the domain docs are pretty clear about why they are deprecated, as well as pretty clear that the API will remain for the forseeable future.