1899614 - Make docs for GeckoView deprecate process more clear

Status: RESOLVED FIXED

(GeckoView :: General, task, P1)

Description

[Nicholas Poon (redirect NI to [e-mail]) [:Nick]]

There are a few issues that I have identified that this bug should fix:

• Since javadocs for the deprecated method should also be updated, that should be mentioned in the doc
• An example / suggestion / standard should be created for naming the identifier of the @DeprecationSchedule header
• Since this is a public API, the changelog should always be updated so the wording of "If the linter asks you to update the changelog" should be reworded
• An example of deprecation in the changelog would be nice / explanation of what should be included
• An explanation of how to determine the minor version should be explained and the corresponding java_doc path
• Some sentences can be reordered to be more clear

Comment 1

[Nicholas Poon [:Nick]]

Attachment: Bug 1899614 - Make docs for GeckoView deprecate process more clear

Comment 2

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/35e50951af30
Make docs for GeckoView deprecate process more clear r=geckoview-reviewers,calu

Comment 3

[Serban Stanca [:SerbanS]]

https://hg.mozilla.org/mozilla-central/rev/35e50951af30