1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-06-18 11:29:55 +00:00

Docs: Improve deprecation documentation

This commit is contained in:
jeremy@jermolene.com 2022-07-04 17:42:58 +01:00
parent 4185d9a26c
commit 20df381cf3
4 changed files with 10 additions and 14 deletions

View File

@ -1,11 +1,11 @@
caption: {{!!title}} - ^^deprecated^^
created: 20141001132300000
modified: 201804111739
modified: 20220704174221300
tags: [[How to apply custom styles]] $:/deprecated
title: How to apply custom styles by tag
type: text/vnd.tiddlywiki
<<.deprecated-since "5.1.16 <- click" "Custom styles by data-tags">>. Also see: [[How to apply custom styles]]
<<.deprecated-since "5.1.16" "Custom styles by data-tags">>. Also see: [[How to apply custom styles]]
----

View File

@ -1,8 +1,8 @@
created: 20170126143833588
modified: 201804111739
modified: 20220704174221300
title: $:/deprecated
type: text/vnd.tiddlywiki
<<<
In several fields, deprecation is the discouragement of use of some feature, design or practice; typically because it has been superseded or is no longer considered safe but without completely removing it or prohibiting its use.
<<< [[wikipedia|https://en.wikipedia.org/wiki/Deprecation]]
Deprecated features of TiddlyWiki are those that have been superseded by newer, improved ways of doing the same thing.
Deprecated features will still work, but are not recommended for new content.

View File

@ -1,15 +1,11 @@
created: 20170126142116898
modified: 201804111739
modified: 20220704174221300
title: Deprecated - What does it mean
type: text/vnd.tiddlywiki
First of all: ''Keep calm!''
{{$:/deprecated}}
For ~TiddlyWiki it means that you should not use this mechanism for new content anymore, ''AND you should update your existing content''!
Deprecated features have a marker. See: [[How to apply custom styles by tag]]
Deprecated features are marked with a special warning button. See: [[How to apply custom styles by tag]] for an example.
''Tiddlers tagged `$:/deprecated`''

View File

@ -1,5 +1,5 @@
created: 20161008085627406
modified: 201804111739
modified: 20220704174221300
tags: $:/tags/Macro
title: $:/editions/tw5.com/version-macros
type: text/vnd.tiddlywiki
@ -9,7 +9,7 @@ type: text/vnd.tiddlywiki
\end
\define .deprecated-since(version, superseded:"TODO-Link")
<$link to="Deprecated - What does it mean" class="doc-deprecated-version tc-btn-invisible">{{$:/core/images/warning}} Deprecated since: <$text text=<<__version__>>/></$link>. Use <$link to=<<__superseded__>>><$text text=<<__version__>>/></$link> instead
<$link to="Deprecated - What does it mean" class="doc-deprecated-version tc-btn-invisible">{{$:/core/images/warning}} Deprecated since: <$text text=<<__version__>>/></$link>. Use <$link to=<<__superseded__>>><$text text=<<__superseded__>>/></$link> instead
\end
<pre><$view field="text"/></pre>