You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Update API docs to conform with doc standards #22893
We hardly have value tags anywhere in our docs (seems like 12 occurrences in the core project, I've personally never understood why those are needed in addition to the summary). If we think it's important, maybe open a separate issue for a larger effort?
We discussed this issue in triage briefly and determined that we should do something to avoid empty "Property Value" on the doc page. Adding value tag resolves that. The task item in triage was to figure out API docs guidelines from docs team, which I sent in an email. We will discuss this in next meeting.
Activity
roji commentedon Oct 3, 2020
This property has already been documented for 5.0 (along with many others), but the updated docs will only be visible when 5.0 is released.
smitpatel commentedon Oct 3, 2020
Missing value tags in XML docs.
roji commentedon Oct 3, 2020
We hardly have value tags anywhere in our docs (seems like 12 occurrences in the core project, I've personally never understood why those are needed in addition to the summary). If we think it's important, maybe open a separate issue for a larger effort?
smitpatel commentedon Oct 3, 2020
We discussed this issue in triage briefly and determined that we should do something to avoid empty "Property Value" on the doc page. Adding value tag resolves that. The task item in triage was to figure out API docs guidelines from docs team, which I sent in an email. We will discuss this in next meeting.
[-]Completely useless[/-][+]Update API docs to conform with doc standards[/+]