Skip to content

[Discussion] How do we deal with deprecated documentation sources? #56

@codeZeilen

Description

@codeZeilen

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions