Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feedback for Editing Typescript page #613

Closed
octref opened this issue Sep 29, 2016 · 1 comment
Closed

Feedback for Editing Typescript page #613

octref opened this issue Sep 29, 2016 · 1 comment
Assignees
Milestone

Comments

@octref
Copy link
Contributor

octref commented Sep 29, 2016

Moved from https://github.com/Microsoft/vscode-website/issues/503

https://code.visualstudio.com/docs/languages/typescript

  • intelliSense for launch/tasks.json is not main selling point. intelliSense for TypeScript is. Not even a single picture shows this feature.
  • No instruction on getting typings. For either TS1 or TS2.
  • Need its own debugging section. People don't want to go to yet another page and start over a new project to learn debugging:
    image
  • No completed repository on GitHub. People wouldn't know how to get it right if they did something wrong. Also this means people can't copy-paste from an official working project.
  • Finally, this is not designed as a flow/tutorial/walk-through. It just touches various points. Would be much better if if starts from an empty repo, and guide the user through step by step while introducing features, and finally have a GitHub repo where each commit corresponds to a single step.
  • Should include some info for structuring the project.
  • Finally, too long. Better split content into sequential sections and include a table of content at top/sidebar.

Here is a good example: http://electron.atom.io/docs/tutorial/quick-start/
I've tried my friends before and most of them can get it to work under 3 min.

@waderyan

@waderyan waderyan removed their assignment Sep 29, 2016
@gregvanl gregvanl added this to the backlog milestone Feb 9, 2017
@gregvanl gregvanl added TypeScript and removed triage labels Feb 9, 2017
@gregvanl gregvanl modified the milestones: backlog, January 2019 Jan 15, 2019
@gregvanl gregvanl self-assigned this Jan 15, 2019
@gregvanl
Copy link

gregvanl commented Jan 30, 2019

We've refactored the TypeScript topic into:
languages/typescript - value proposition overview for using TypeScript in VS Code (Matt has some TODO left)

typescript/typescript-tutorial - hello world example
typescript/typescript-compiling - shows tasks and compiler information
typescript/typescript-debugging - shows Node.js and client-side debugging

These changes are in vscode-docs vnext and will publish with 1.31.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants