Skip to content

Near-Term Website Simplications (March 2023) #2728

@DanielRosenwasser

Description

@DanielRosenwasser

The primary use-case for the website is to learn how to use TypeScript. We think there are some opportunities to simplify our pages to avoid overwhelming newcomers. Additionally, we have a lot of UI whose surface area translates to testing costs that often need to be repeated.

After discussing among @RyanCavanaugh, @navya9singh, and others, we came to a list of near-term improvements we'd like to make. So in the next month or two, we'd like to make the following simplifications:

  • Remove "Popular Documentation Pages" from the footer
  • Remove duplicate "Get Started" sections on the landing page
  • Remove header link to Handbook (prefer Docs), possible rename to "Documentation"
  • Make Docs a special page within the same docs view that the handbook, references pages, etc. live
  • Investigate whether the build tool integration page can link out to external resources
  • Move Branding page to a GitHub repo
  • Move Cheat Sheets to a docs page or GitHub repo
  • Delist Tools from the header
  • Remove "Errors" view and "Plugins" view from the TypeScript Playground

Metadata

Metadata

Assignees

Labels

FeatureNew conceptsPlaygroundIssues that affect the PlaygroundPlayground PluginsRelates to pluginsdocumentationChanges only affect the documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions