You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ja...@apache.org on 2018/08/23 13:00:02 UTC

[cordova-contribute] branch janpio-deprecation updated (e8baa8d -> 5611a75)

This is an automated email from the ASF dual-hosted git repository.

janpio pushed a change to branch janpio-deprecation
in repository https://gitbox.apache.org/repos/asf/cordova-contribute.git.


    omit e8baa8d  more polish
    omit 14fdd66  polish
    omit b7a9763  remove mailing list reference
    omit 90e92b9  simplify
    omit 40183b3  one deprecation notice template is enough
    omit 245c8d0  extract actual deprecation policy
    omit 22bcbd6  First draft of a "Deprecation and Archiving Policy" (notice templates are unfinished)
     add ffbb522  .editorconfig for better code and markdown auto-formatting
     new ac494bb  First draft of a "Deprecation and Archiving Policy" (notice templates are unfinished)
     new 1134f65  extract actual deprecation policy
     new 38279c5  one deprecation notice template is enough
     new dc20d59  simplify
     new bb91cd1  remove mailing list reference
     new 9493f34  polish
     new 5611a75  more polish

This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version.  This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:

 * -- * -- B -- O -- O -- O   (e8baa8d)
            \
             N -- N -- N   refs/heads/janpio-deprecation (5611a75)

You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.

Any revisions marked "omit" are not gone; other references still
refer to them.  Any revisions marked "discard" are gone forever.

The 7 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 .editorconfig | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 .editorconfig


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[cordova-contribute] 02/07: extract actual deprecation policy

Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

janpio pushed a commit to branch janpio-deprecation
in repository https://gitbox.apache.org/repos/asf/cordova-contribute.git

commit 1134f653d752162dcbea9f2aca7942b28b8de36d
Author: Jan Piotrowski <pi...@gmail.com>
AuthorDate: Wed Aug 22 20:13:15 2018 +0200

    extract actual deprecation policy
---
 deprecation.md | 40 ----------------------------------------
 1 file changed, 40 deletions(-)

diff --git a/deprecation.md b/deprecation.md
index 470e9ae..14d6c35 100644
--- a/deprecation.md
+++ b/deprecation.md
@@ -1,43 +1,3 @@
-# Deprecation and Archiving Policy
-
-Apache Cordova has been around quite some time, having been started back in August 2008. As it consists of many individual "parts", some of those stopped being useful for any number of reasons. This "Deprecation and Archiving Policy" describes why, when and how projects can be deprecated and archived - and what that actually means.
-
-## Deprecation Policy
-
-When a piece of Apache Cordova stops being useful or necessary we vote on deprecating it on our [dev mailing list](mailing-lists.md).
-
-### Reasons for Deprecation
-
-Common reasons for deprecation of a piece of Apache Cordova are:
-
-- General availability of a web standard that achieves the same thing
-- A better replacement is available somewhere else
-- Usage of a platform declined to a non relevant level
-- A platform was deprecated itself by its producer
-
-### Meaning of Deprecation
-
-When we deprecate something it means no more work will be done on it. We make the deprecation clearly visible in the project's `README.md` (see [Deprecation notice templates](#deprecation-and-archiving-notice-templates) which might also include a reason and links to alternatives if available) and repository description.
-
-**Users can still use the software** as before, we just put them on notice that the software might break in the future - e.g. with new operating system releases or bugs might be found - and we won't fix this any more.
-
-**Users can also still fork the repository** and create their own bug fixes and even new features. The forks will be discoverable with the GitHub "Network" and "Forks" features. There you can see all forks available and easily spot extra commits people have done in an easy and visual way.
-
-**Cordova might still accept bug fix Pull Requests** on the original repository and create a patch release.
-
-## Archiving Policy
-
-A deprecated repository might also be archived when we won't provide support of any kind (Issues, Pull Requests, any releases) for this piece of software any more. Again the decision is made on our [dev mailing list](mailing-lists.md).
-
-A repository can be deprecated and archived at the same time.
-
-### Meaning of Archiving
-
-Additionally to the points listed in [Meaning of Deprecation](#meaning-of-deprecation), an archived repository is "read only" in any way: No more commits, Issues or Pull Requests are possible.
-
-This is achieved by using GitHub's [archive repositories](https://help.github.com/articles/about-archiving-repositories/) feature:
-
-> When a repository is archived, its issues, pull requests, code, labels, milestones, projects, wiki, releases, commits, tags, branches, reactions, and comments become read-only. To make changes in an archived repository, you must unarchive the repository first.
 
 ## Deprecating or Archiving a Repository
 


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[cordova-contribute] 07/07: more polish

Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

janpio pushed a commit to branch janpio-deprecation
in repository https://gitbox.apache.org/repos/asf/cordova-contribute.git

commit 5611a7555cffa3c2bb862f6226faefce1f3cfb1c
Author: Jan Piotrowski <pi...@gmail.com>
AuthorDate: Wed Aug 22 20:45:03 2018 +0200

    more polish
---
 deprecation.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/deprecation.md b/deprecation.md
index c09e9d0..56f5c37 100644
--- a/deprecation.md
+++ b/deprecation.md
@@ -6,29 +6,29 @@
 
 ### 1. Make changes in `README.md`
 
-Add the [Deprecation Notice Template](#deprecation-notice-templates) to the `README.md` of the project. Add a reason and a link to further information (e.g. blog post, web standard definition etc.).
+Add the [Deprecation Notice Template](#deprecation-notice-template) to the `README.md` of the project. Add a reason and a link to further information (e.g. blog post, web standard definition etc.).
 
 ### 2. Request GitHub repository changes
 
-A [PMC](TODO) member has to [open an issue with Apache INFRA](https://issues.apache.org/jira/browse/INFRA) to request changes to the GitHub repository.
+A PMC member has to [open an issue with Apache INFRA](https://issues.apache.org/jira/browse/INFRA) to request changes to the GitHub repository.
 
 For deprecation:
 
 1. Make sure deprecation notice is in `README.md` and contains all information
-1. [Open an issue](https://issues.apache.org/jira/browse/INFRA) and request that the repository description is prefixed with `[DEPRECTATED]`
+1. [Open an issue](https://issues.apache.org/jira/browse/INFRA) and request that the repository description is prefixed with `[DEPRECATED]`
 
 For archiving:
 
 1. Make sure there are no more open Issues and Pull Requests for this repository  
-If there are, please close them with this suggested text or similar:
-   > TODO  
-   > We are archiving this repository following our deprecation policy documented at ..TODO..  
-   > Thanks for your issue or pull request anyway.  
-   > TODO
+   If there are, please close them with this suggested text or similar:
+   > We are archiving this repository following [Apache Cordova's Deprecation Policy](https://cordova.apache.org/deprecation_policy.html). We won't do any more work on this repository therefore all Issues and Pull Requests are closed. Thanks for your issue or pull request.  
+   ```markdown
+   We are archiving this repository following [Apache Cordova's Deprecation Policy](https://cordova.apache.org/deprecation_policy.html). We won't do any more work on this repository therefore all Issues and Pull Requests are closed. Thanks for your issue or pull request.
+   ```
 1. Make sure deprecation notice is in `README.md` and contains all information
-1. [Open an issue](https://issues.apache.org/jira/browse/INFRA) and request a) that the repository description is prefixed with `[DEPRECTATED]` and b) the repository is archived on GitHub
+1. [Open an issue](https://issues.apache.org/jira/browse/INFRA) and request that a) the repository description is prefixed with `[DEPRECATED]` and b) the repository is archived on GitHub
 
-## Deprecation Notice Templates
+## Deprecation Notice Template
 
 ---
 **Deprecation Notice**


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[cordova-contribute] 06/07: polish

Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

janpio pushed a commit to branch janpio-deprecation
in repository https://gitbox.apache.org/repos/asf/cordova-contribute.git

commit 9493f34d26cebdeb0dd37a3c3e7c10fc51f7e4a2
Author: Jan Piotrowski <pi...@gmail.com>
AuthorDate: Wed Aug 22 20:21:35 2018 +0200

    polish
---
 README.md      |  2 +-
 deprecation.md | 26 +++++++++++++++-----------
 2 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 6b25209..135b9ce 100644
--- a/README.md
+++ b/README.md
@@ -8,4 +8,4 @@ This repository contains documents describing everything a contributor of Apache
 
 ### Process
 
-- [Deprecation Policy](deprecation.md)
\ No newline at end of file
+- [Deprecation and Archiving of Repositories](deprecation.md)
\ No newline at end of file
diff --git a/deprecation.md b/deprecation.md
index 8a5c9d3..c09e9d0 100644
--- a/deprecation.md
+++ b/deprecation.md
@@ -1,28 +1,32 @@
+# Deprecation and Archiving
+
+[Apache Cordova's Deprecation Policy](https://cordova.apache.org/deprecation_policy.html) defines why, when and how Cordova projects are deprecated and archived. These are the steps to be taken by a contributor to "execute" such an deprecation:
 
 ## Deprecating or Archiving a Repository
 
-### 1. Make changes in README
+### 1. Make changes in `README.md`
 
-Add the [Deprecation Notice Template](#deprecation-notice-templates) to the `README.md` of the project. Add a reason and a link to further information (blog post, web standard definition etc.).
+Add the [Deprecation Notice Template](#deprecation-notice-templates) to the `README.md` of the project. Add a reason and a link to further information (e.g. blog post, web standard definition etc.).
 
-### 2. Request GitHub repository archiving
+### 2. Request GitHub repository changes
 
-To request archiving of a repository, a [PMC](TODO) member has to [open an issue with Apache INFRA](https://issues.apache.org/jira/browse/INFRA).
+A [PMC](TODO) member has to [open an issue with Apache INFRA](https://issues.apache.org/jira/browse/INFRA) to request changes to the GitHub repository.
 
 For deprecation:
 
-1. Make sure deprecation notice is in README and contains all information
-1. [Open an issue](https://issues.apache.org/jira/browse/INFRA) and request that the repository description is prefixed with [DEPRECTATED]
+1. Make sure deprecation notice is in `README.md` and contains all information
+1. [Open an issue](https://issues.apache.org/jira/browse/INFRA) and request that the repository description is prefixed with `[DEPRECTATED]`
 
 For archiving:
 
-1. Make sure there are no more open issues and Pull Requests for this repository. If there are, please close them with this suggested text or similar:
+1. Make sure there are no more open Issues and Pull Requests for this repository  
+If there are, please close them with this suggested text or similar:
    > TODO  
    > We are archiving this repository following our deprecation policy documented at ..TODO..  
    > Thanks for your issue or pull request anyway.  
    > TODO
-1. Make sure deprecation notice is in README and contains all information
-1. [Open an issue](https://issues.apache.org/jira/browse/INFRA) and request a) that the repository description is prefixed with [DEPRECTATED] and b) the repository is archived.
+1. Make sure deprecation notice is in `README.md` and contains all information
+1. [Open an issue](https://issues.apache.org/jira/browse/INFRA) and request a) that the repository description is prefixed with `[DEPRECTATED]` and b) the repository is archived on GitHub
 
 ## Deprecation Notice Templates
 
@@ -31,7 +35,7 @@ For archiving:
 
 This repository is deprecated and no more work will be done on this by Apache Cordova. You can continue to use this and it should work as-is in the future but any more future issues will not be fixed by the Cordova community.
 
-Feel free to fork this repository and work on your fork. Existing forks are listed in [Network](network) and [Forks](network/members).
+Feel free to fork this repository and improve your fork. Existing forks are listed in [Network](network) and [Forks](network/members).
 
 - Reason for deprecation: ...
 - Learn more: https://example.org/article
@@ -45,7 +49,7 @@ Feel free to fork this repository and work on your fork. Existing forks are list
 
 This repository is deprecated and no more work will be done on this by Apache Cordova. You can continue to use this and it should work as-is in the future but any more future issues will not be fixed by the Cordova community.
 
-Feel free to fork this repository and work on your fork. Existing forks are listed in [Network](network) and [Forks](network/members).
+Feel free to fork this repository and improve your fork. Existing forks are listed in [Network](network) and [Forks](network/members).
 
 - Reason for deprecation: ...
 - Learn more: https://example.org/article


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[cordova-contribute] 03/07: one deprecation notice template is enough

Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

janpio pushed a commit to branch janpio-deprecation
in repository https://gitbox.apache.org/repos/asf/cordova-contribute.git

commit 38279c55f7011f0bcb6a178f92c68a892e32597a
Author: Jan Piotrowski <pi...@gmail.com>
AuthorDate: Wed Aug 22 20:14:05 2018 +0200

    one deprecation notice template is enough
---
 deprecation.md | 30 ++++++++++++++----------------
 1 file changed, 14 insertions(+), 16 deletions(-)

diff --git a/deprecation.md b/deprecation.md
index 14d6c35..52cfbd7 100644
--- a/deprecation.md
+++ b/deprecation.md
@@ -24,33 +24,31 @@ For archiving:
 ## Deprecation and Archiving notice templates
 
 ### Deprecated Repository
+## Deprecation Notice Templates
 
-```markdown
 ---
 **Deprecation Notice**
-This repo is deprecated. No more development, we still might release security fixes and other necessary patch updates. Please find other way to solve the problem.
-- Reason for deprecation: ...
-- Relevant links: ...
-Feel free to fork this repository and work on your fork. Your fork will show up in https://github.com/apache/cordova-.../network/member where other users can look for updated forks.
 
-No more work will be done on this plugin by the Cordova development community. You can continue to use this plugin and it should work as-is in the future but any more arising issues will not be fixed by the Cordova community.
+This repository is deprecated and no more work will be done on this by Apache Cordova. You can continue to use this and it should work as-is in the future but any more future issues will not be fixed by the Cordova community.
+
+Feel free to fork this repository and work on your fork. Existing forks are listed in [Network](network) and [Forks](network/members).
+
+- Reason for deprecation: ...
+- Learn more: https://example.org/article
 ---
-```
 
-### Archived Repository
+### Markdown
 
 ```markdown
 ---
-**Deprecation and Archiving Notice**
-This repo is archived. No more development.
-GitHub repository is archived, which means no more code changes, issues or pull requests.
-- Reason for deprecation: ...
-- Relevant links: ...
-Feel free to fork this repository and work on your fork.
----
-```
+**Deprecation Notice**
 
+This repository is deprecated and no more work will be done on this by Apache Cordova. You can continue to use this and it should work as-is in the future but any more future issues will not be fixed by the Cordova community.
 
+Feel free to fork this repository and work on your fork. Existing forks are listed in [Network](network) and [Forks](network/members).
+
+- Reason for deprecation: ...
+- Learn more: https://example.org/article
 ---
 > Mailing list discussion on the topic:
 > https://lists.apache.org/thread.html/34369ada22f8a616e90471d38c8fd7def2eb17ff3ddbf4ba0b47987f@%3Cdev.cordova.apache.org%3E
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[cordova-contribute] 05/07: remove mailing list reference

Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

janpio pushed a commit to branch janpio-deprecation
in repository https://gitbox.apache.org/repos/asf/cordova-contribute.git

commit bb91cd14ac49c8a2804b4f835f5720ac58d8119d
Author: Jan Piotrowski <pi...@gmail.com>
AuthorDate: Wed Aug 22 20:15:15 2018 +0200

    remove mailing list reference
---
 deprecation.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/deprecation.md b/deprecation.md
index e3b7951..8a5c9d3 100644
--- a/deprecation.md
+++ b/deprecation.md
@@ -50,5 +50,4 @@ Feel free to fork this repository and work on your fork. Existing forks are list
 - Reason for deprecation: ...
 - Learn more: https://example.org/article
 ---
-> Mailing list discussion on the topic:
-> https://lists.apache.org/thread.html/34369ada22f8a616e90471d38c8fd7def2eb17ff3ddbf4ba0b47987f@%3Cdev.cordova.apache.org%3E
\ No newline at end of file
+```
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[cordova-contribute] 04/07: simplify

Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

janpio pushed a commit to branch janpio-deprecation
in repository https://gitbox.apache.org/repos/asf/cordova-contribute.git

commit dc20d593b39b59d126542cf2915d613777b991f6
Author: Jan Piotrowski <pi...@gmail.com>
AuthorDate: Wed Aug 22 20:14:27 2018 +0200

    simplify
---
 deprecation.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/deprecation.md b/deprecation.md
index 52cfbd7..e3b7951 100644
--- a/deprecation.md
+++ b/deprecation.md
@@ -3,7 +3,7 @@
 
 ### 1. Make changes in README
 
-Add the [deprecation or archiving notice template](#deprecation-and-archiving-notice-templates) to the `README.md` of the project.
+Add the [Deprecation Notice Template](#deprecation-notice-templates) to the `README.md` of the project. Add a reason and a link to further information (blog post, web standard definition etc.).
 
 ### 2. Request GitHub repository archiving
 
@@ -12,18 +12,18 @@ To request archiving of a repository, a [PMC](TODO) member has to [open an issue
 For deprecation:
 
 1. Make sure deprecation notice is in README and contains all information
-1. Open an issue and request that the repository description is prefixed with [DEPRECTATED]
+1. [Open an issue](https://issues.apache.org/jira/browse/INFRA) and request that the repository description is prefixed with [DEPRECTATED]
 
 For archiving:
 
 1. Make sure there are no more open issues and Pull Requests for this repository. If there are, please close them with this suggested text or similar:
-   > We are archiving this repository following our deprecation policy documented at ..TODO.. Thanks for your issue or pull request anyway.
+   > TODO  
+   > We are archiving this repository following our deprecation policy documented at ..TODO..  
+   > Thanks for your issue or pull request anyway.  
+   > TODO
 1. Make sure deprecation notice is in README and contains all information
-1. Open an issue and request a) that the repository description is prefixed with [DEPRECTATED] and b) the repository is archived.
+1. [Open an issue](https://issues.apache.org/jira/browse/INFRA) and request a) that the repository description is prefixed with [DEPRECTATED] and b) the repository is archived.
 
-## Deprecation and Archiving notice templates
-
-### Deprecated Repository
 ## Deprecation Notice Templates
 
 ---


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[cordova-contribute] 01/07: First draft of a "Deprecation and Archiving Policy" (notice templates are unfinished)

Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

janpio pushed a commit to branch janpio-deprecation
in repository https://gitbox.apache.org/repos/asf/cordova-contribute.git

commit ac494bb8bf9d2ae3d792f5df9a74ad31d0f2eeca
Author: Jan Piotrowski <pi...@gmail.com>
AuthorDate: Wed Aug 22 19:17:02 2018 +0200

    First draft of a "Deprecation and Archiving Policy"
    (notice templates are unfinished)
---
 README.md      |  3 ++
 deprecation.md | 96 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 99 insertions(+)

diff --git a/README.md b/README.md
index f56ff10..6b25209 100644
--- a/README.md
+++ b/README.md
@@ -6,3 +6,6 @@ This repository contains documents describing everything a contributor of Apache
 
 ## Topics
 
+### Process
+
+- [Deprecation Policy](deprecation.md)
\ No newline at end of file
diff --git a/deprecation.md b/deprecation.md
new file mode 100644
index 0000000..470e9ae
--- /dev/null
+++ b/deprecation.md
@@ -0,0 +1,96 @@
+# Deprecation and Archiving Policy
+
+Apache Cordova has been around quite some time, having been started back in August 2008. As it consists of many individual "parts", some of those stopped being useful for any number of reasons. This "Deprecation and Archiving Policy" describes why, when and how projects can be deprecated and archived - and what that actually means.
+
+## Deprecation Policy
+
+When a piece of Apache Cordova stops being useful or necessary we vote on deprecating it on our [dev mailing list](mailing-lists.md).
+
+### Reasons for Deprecation
+
+Common reasons for deprecation of a piece of Apache Cordova are:
+
+- General availability of a web standard that achieves the same thing
+- A better replacement is available somewhere else
+- Usage of a platform declined to a non relevant level
+- A platform was deprecated itself by its producer
+
+### Meaning of Deprecation
+
+When we deprecate something it means no more work will be done on it. We make the deprecation clearly visible in the project's `README.md` (see [Deprecation notice templates](#deprecation-and-archiving-notice-templates) which might also include a reason and links to alternatives if available) and repository description.
+
+**Users can still use the software** as before, we just put them on notice that the software might break in the future - e.g. with new operating system releases or bugs might be found - and we won't fix this any more.
+
+**Users can also still fork the repository** and create their own bug fixes and even new features. The forks will be discoverable with the GitHub "Network" and "Forks" features. There you can see all forks available and easily spot extra commits people have done in an easy and visual way.
+
+**Cordova might still accept bug fix Pull Requests** on the original repository and create a patch release.
+
+## Archiving Policy
+
+A deprecated repository might also be archived when we won't provide support of any kind (Issues, Pull Requests, any releases) for this piece of software any more. Again the decision is made on our [dev mailing list](mailing-lists.md).
+
+A repository can be deprecated and archived at the same time.
+
+### Meaning of Archiving
+
+Additionally to the points listed in [Meaning of Deprecation](#meaning-of-deprecation), an archived repository is "read only" in any way: No more commits, Issues or Pull Requests are possible.
+
+This is achieved by using GitHub's [archive repositories](https://help.github.com/articles/about-archiving-repositories/) feature:
+
+> When a repository is archived, its issues, pull requests, code, labels, milestones, projects, wiki, releases, commits, tags, branches, reactions, and comments become read-only. To make changes in an archived repository, you must unarchive the repository first.
+
+## Deprecating or Archiving a Repository
+
+### 1. Make changes in README
+
+Add the [deprecation or archiving notice template](#deprecation-and-archiving-notice-templates) to the `README.md` of the project.
+
+### 2. Request GitHub repository archiving
+
+To request archiving of a repository, a [PMC](TODO) member has to [open an issue with Apache INFRA](https://issues.apache.org/jira/browse/INFRA).
+
+For deprecation:
+
+1. Make sure deprecation notice is in README and contains all information
+1. Open an issue and request that the repository description is prefixed with [DEPRECTATED]
+
+For archiving:
+
+1. Make sure there are no more open issues and Pull Requests for this repository. If there are, please close them with this suggested text or similar:
+   > We are archiving this repository following our deprecation policy documented at ..TODO.. Thanks for your issue or pull request anyway.
+1. Make sure deprecation notice is in README and contains all information
+1. Open an issue and request a) that the repository description is prefixed with [DEPRECTATED] and b) the repository is archived.
+
+## Deprecation and Archiving notice templates
+
+### Deprecated Repository
+
+```markdown
+---
+**Deprecation Notice**
+This repo is deprecated. No more development, we still might release security fixes and other necessary patch updates. Please find other way to solve the problem.
+- Reason for deprecation: ...
+- Relevant links: ...
+Feel free to fork this repository and work on your fork. Your fork will show up in https://github.com/apache/cordova-.../network/member where other users can look for updated forks.
+
+No more work will be done on this plugin by the Cordova development community. You can continue to use this plugin and it should work as-is in the future but any more arising issues will not be fixed by the Cordova community.
+---
+```
+
+### Archived Repository
+
+```markdown
+---
+**Deprecation and Archiving Notice**
+This repo is archived. No more development.
+GitHub repository is archived, which means no more code changes, issues or pull requests.
+- Reason for deprecation: ...
+- Relevant links: ...
+Feel free to fork this repository and work on your fork.
+---
+```
+
+
+---
+> Mailing list discussion on the topic:
+> https://lists.apache.org/thread.html/34369ada22f8a616e90471d38c8fd7def2eb17ff3ddbf4ba0b47987f@%3Cdev.cordova.apache.org%3E
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org