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
How do we deal with deprecated documentation sources on the web page?
The following situation just came up: I discovered that the link on Waveplace Beta Morphic Tutorials on Documentation does not work anymore. I was able to retrieve an earlier version from Wayback Machine: old version. When thinking about how to fix this I thought to either:
a) remove the link completely
b) use the wayback machine URL
I don't like either solution. a) is the clean solution that leads to a documentation page that is useful for current users of Squeak. b) keeps original resources on Squeak around which might be useful for special purposes but makes the documentation page much less useful for current/new users.
There might be an alternative c) which is to add a "Deprecated Documentations" section. However, this might lead to many of the current documentation links to be moved to that section.
Other thoughts? I have no strong opinion other than that we should improve the Documentation page so that new users can quickly find information that is actually useful to them.
The text was updated successfully, but these errors were encountered:
How do we deal with deprecated documentation sources on the web page?
The following situation just came up: I discovered that the link on Waveplace Beta Morphic Tutorials on Documentation does not work anymore. I was able to retrieve an earlier version from Wayback Machine: old version. When thinking about how to fix this I thought to either:
a) remove the link completely
b) use the wayback machine URL
I don't like either solution. a) is the clean solution that leads to a documentation page that is useful for current users of Squeak. b) keeps original resources on Squeak around which might be useful for special purposes but makes the documentation page much less useful for current/new users.
There might be an alternative c) which is to add a "Deprecated Documentations" section. However, this might lead to many of the current documentation links to be moved to that section.
Other thoughts? I have no strong opinion other than that we should improve the Documentation page so that new users can quickly find information that is actually useful to them.
The text was updated successfully, but these errors were encountered: