Difference between revisions of "Template:Deprecated page"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 10: Line 10:
</blockquote>
</blockquote>


The full process is this:
This pragma is added in the third stage of the deprecation process:
:* This pragma is added in the third stage of the deprecation process.
:* In the first stage, a [[Template:DeprecationPlanned]] note is added at the top of existing documentation. Users can still see it, but have a warning that it will be deprecated.
:* In the first stage, a [[Template:Deprecation Planned]] note is added at the top of existing documentation. Users can still see it, but have a warning that it will be deprecated.
:* In the second stage, [[Template:Deprecated]] note is added, saying that the feature has been deprecated. Most if not all of the links to the page are removed, making it harder to find. (Often, the process starts here. Deprecation planned is used when there is a serious impact that requires plenty of warning.)
:* In the second stage, [[Template:Deprecated]] note is added, saying that the feature has been deprecated. (Often, the process starts here. Deprecation planned is used when there is a serious impact that requires plenty of warning.)
:* In the third stage, the material is removed, and replaced by this pragma, which points to a previous version of the documentation to find it. All links to the page are removed. (That way, browsing and searching doesn't surface old material, but bookmarks will still work.)  
:* In the third stage, the material is removed, and replaced by this pragma, which points to a previous version of the documentation to find it. (That way, searches won't surface old material, but bookmarks will still work.)  
:* In final stage, the page is removed entirely. (Generally when it surfaces in some sort of clean up process.)
:* In final stage, the page is removed entirely.
</noinclude>
</noinclude>

Revision as of 20:16, 20 March 2014

For information on this deprecated functionality, see the version {{{1}}} platform docs:
https://agileappscloud.info/{{{2}}}/index.php?title=Deprecated_page



Usage

{{deprecated_page|{version}|{wiki}}}

=> "see the version {version} docs at .../{wiki}/{page with same name as current page}

This pragma is added in the third stage of the deprecation process:

  • In the first stage, a Template:DeprecationPlanned note is added at the top of existing documentation. Users can still see it, but have a warning that it will be deprecated.
  • In the second stage, Template:Deprecated note is added, saying that the feature has been deprecated. Most if not all of the links to the page are removed, making it harder to find. (Often, the process starts here. Deprecation planned is used when there is a serious impact that requires plenty of warning.)
  • In the third stage, the material is removed, and replaced by this pragma, which points to a previous version of the documentation to find it. All links to the page are removed. (That way, browsing and searching doesn't surface old material, but bookmarks will still work.)
  • In final stage, the page is removed entirely. (Generally when it surfaces in some sort of clean up process.)